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CHAPTER ONE 



Introduction 



In this chapter we will give you a brief description of your UltraTerm and 
some directions on how you can best use this manual. Please take a few 
minutes to read this chapter, then decide which other chapters of the 
manual you will need to examine. A few moments spent with this manual 
will make the installation of your UltraTerm an easier, faster, and more 
satisfying procedure. 



Section 1 .a HOW TO USE THIS MANUAL 

We have written this manual with four goals in mind. They are: 

1 . To provide orientation and installation instructions for all users. 

2. To provide a tutorial presentation for new users. 

3. To provide complete and concise reference information for 
advanced users. 

4. To provide complete technical specifications for programmers 
who will incorporate UltraTerm features into their products. 

You should need no other documents to completely understand and 
successfully use your UltraTerm. Please let us know if you find any area of 
our documentation inadequate. 



Section 1 .a.1 MANUAL ORGANIZATION 



We have designed this manual to be useful to beginners, advanced users 
and hardware/software wizards. To help us organize our presentation 
more effectively, we have broken this (and all our other manuals) into five 
major parts: 



Parti 



Part II 



Part III 



(Installation and troubleshooting) [Ch. 1-3] This section will 
help you learn the basic principles of the UltraTerm, install the 
card in your Apple ][, and use the new features this card adds 
to your personal computer system. 

(Product Definition and Use) [Ch. 4-5] This section will help 
you to learn to use the full power of your UltraTerm. The 
complete command structure and all the user options are 
described in this section. Both beginners and advanced users 
will find this section useful. 

(The Software Interface ) [Ch. 6-8] In this section we will 
describe the interaction of the UltraTerm with the most popular 
operating systems used with the Apple ][. We will also 
describe the ways in which the card can be used with certain 
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specific software systems such as word processors, data 
communication systems and data base management 
programs. 

Part IV (The Hardware Interface) [Ch. 9] The requirements for the 
video display monitor to be used with the UltraTerm are 
detailed in this section. The possible interactions between the 
UltraTerm and other peripheral cards installed in your Apple ][ 
are also examined in this section. 

Part V (Technical Notes) [Appendices] We have included a complete 
schematic diagram, listings of the UltraTerm firmware and 
complete technical specifications on the video display 
controller circuit in this section. This section will be useful 
primarily to advanced users and hardware and software 
wizards. 

We have, of course, included an Index and a Glossary to make this manual 
easier to use. There is also a tear-out reference card which contains a 
concise list of the UltraTerm commands. 



Section 1 .a.2 NOTATION 

When we are referring to characters or keys on your Apple's keyboard, we 
will enclose them in single quotation marks. For example: 

Striking the 'A' key will cause the letter 'A' to appear at the 
position of the cursor on the video display. 

When we refer to control characters and shifted characters, we will specify 
the keys which need to be pressed, separated by a hyphen, inside the 
single quotation marks. When we are referring to single control characters, 
we will use the ' c ' to indicate the 'CTRL' key. For example. 

Pressing 'G c ' while in BASIC will cause the Apple's speaker to 
produce a beep. The 'SHIFT-1 ' key will cause an exclamation 
mark to be displayed. 

If we are referring to a keyboard entry which does not produce a visible 
character, or if we refer to a character by a name or abbreviation, we will 
enclose the character in triangular brackets. For example: 

Striking 'l c ' will generate the <TAB> character. 

Whenever we refer to character sequences using the control and shift 
keys, you must hold down the first key while you strike the second. 



Section 1 .b PRODUCT OVERVIEW 

Your UltraTerm card is a sophisticated video display peripheral for the 
Apple ][ computer. It allows you to display text generated by your 
computer in 7 different display modes, including 160 characters by 24 



lines and 80 characters by 48 lines. The default start-up mode is 80 
characters by 24 lines— which emulates our Videoterm display. Thus, you 
can use all the special software packages which have been developed for 
the 80-column Videoterm over the last three years. 

Section 1.b.1 THE PRINTED CIRCUIT BOARD 

The UltraTerm system consists of a printed circuit (PC) board and a cable 
to connect the card to your display monitor. The functional areas of the PC 
board are shown in figure 1 1 and described in the following paragraphs. 
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FIGURE 1.1 Block Diagram of the UltraTerm 

Video Connectors and Video Switch These connectors handle the 
input from the Apple's 40-column or graphic output and the 80 or 1 32- 
column output from the UltraTerm. The video switching circuitry allows 
software selection of the signal to be sent to the video display monitor. 

Edge-Card Connector These gold-plated fingers plug into one of the 
expansion slots at the back of your Apple. The connector allows transfer of 
the signals necessary to control the UltraTerm between your Apple and the 
UltraTerm circuitry 

Firmware EPROM This is a Read-Only-Memory chip which contains a 
program that is used by your Apple to control the operation of the 
UltraTerm card. 

Display RAM These memory circuits contain 4096 bytes of random- 
access memory that are used to store the characters which will appear on 
the video monitor when the UltraTerm is in use. 

CRTC This integrated circuit is the heart of your UltraTerm. CRTC is an 
acronym for Cathode Ray Tube Controller. (The display on your video 
monitor is generated on the face of a cathode ray tube. A TV picture tube 
is also a cathode ray tube.) The CRTC is actually a specially-programmed 
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microprocessor which continuously converts the character information in 
the display RAM to video signals to drive your display monitor. 

Character set EPROM This integrated circuit contains the information 
which the CRTC uses to generate a matrix of dots on your display which 
represent a particular character in the display RAM. The EPROM normally 
provided with the UltraTerm contains a standard character set and a high- 
quality character set. 

Section 1 .b.2 VIDEO SIGNAL CONNECTION 

Video signals are routed to the UltraTerm card through the video signal 
cable as shown in figure 1 .2. The video cable has three connectors to 
allow you to connect your display monitor, the UltraTerm card, and the 
normal Apple ][ video signals. At one end of this cable is a male RCA 
phono plug. This plug is inserted in the video output jack on the back of 
your Apple. In the middle of the cable is the keyed 5-connector socket 
which is connected to the 5-pin connector on the UltraTerm card. On the 
other end of the cable is a female RCA phono socket into which you must 
plug the male connector on your monitor cable. 



Molex Connector - To Ultraterm 




Socket 
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Female 

To 

Display 

Monitor 



FIGURE 1 .2 Video Connector Cable 



Section 1 .b.3 SOFTWARE FEATURES 



The firmware EPROM on your UltraTerm provides your Apple ][ with an 
operating program having the following features: 

• Compatibility with these Operating Systems: 

Apple DOS 

Apple Pascal and the Soft Tech P-System 

CPM (When using a Z-80 processor card) 



► Applesoft BASIC and Integer BASIC are supported. 

• Many Word-Processing systems are supported. 

• Upper and lower-case characters may be entered from an 
unmodified keyboard, using 'A c ' to change cases. 

• Operating commands may be generated by program control. 

• A standard set of escape sequences and control characters can 
be used for cursor movement and display editing. 

» Escape sequences can be used to change video display modes 
from the keyboard in BASIC. 

• Display output can be halted and resumed under keyboard 
control. 



Section 1 .b.4 HARDWARE FEATURES 

The state-of-the-art design of the UltraTerm circuitry provides you with 
many features not found on other video display cards: 

• 24-line by 80-column display. 

• 24-line by 96-column display. 

• 32-line by 1 28-column display. 

• 24-line by 132-column display. 

• 48-line by 80-column display— great for editing and word- 
processing users. 

• Several more modes are available with a high-quality character set 
using interlaced display mode. 

• Emulation of Videoterm 24-line by 80-column operation. 

• Character-by-character selection of one of two sets of special 
character attributes. These attributes may include combinations of 
the following: 

Normal/High-resolution character set 
Normal/Inverse video 
Highlight/lowlight characters. 

• Stable, flicker-free display with fast hardware scrolling. 

• Display of all 96 ASCII characters with true descenders on lower- 
case characters. 

• 15-character line-drawing set as part of standard character set. 

• 7-character block graphics font as part of standard character set. 

• Highly readable 7 by 9 dot character font. 

• Operates in any peripheral slot except slot without modification. 

• Complete theory of operation is provided in this manual. 

• Can be used in Apple He with extended memory card. 
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Section 1 .c HARDWARE REQUIREMENTS 



There are two fundamental hardware requirements for successful 
operation of your UltraTerm card. First of all, you must plug the card into an 
Apple ][, Apple ][ Plus, Apple lie or Apple /// computer. Secondly, the video 
output signal must be routed to a high-resolution video display monitor; 



.WARNING. 



Since the UltraTerm in the 132-column mode will send dot 
information to the display almost 60% faster than an 80-column 
device, not all display monitors are suitable. See chapter 9 for a 
more complete discussion of this subject. 



Your display monitor should have a bandwidth of at least 15 megaHertz to 
provide a sharp display in the 132-column mode. We have tested the 
following display monitors and found them to be suitable when properly 
adjusted: 

• Apple Monitor /// (Our recommendation for the UltraTerm) 

• NEC JB-902M (Has some flicker in interlace mode) 

• NEC JB-1201M (Larger display, but still flickers) 

• AMDEK 300A (Amber screen, works with all modes) 



Section 1 .d PRODUCT REGISTRATION 

We have attached a Product Registration Form at the front of this manual. 
We would like you to fill out this form and mail it to us. This information is 
NOT necessary to validate the warranty on your UltraTerm, but it will help 
us to better understand the needs and background of our customers. 

Please answer all questions as completely as you can. If you can't answer 
a question, leave the space blank. If you have any additional comments, 
please use the comment card at the back of the manual or write us a letter. 
These comments will be routed directly to our technical staff. Comments 
on the back of the product registration form are sometimes overlooked. 



CHAPTER TWO 



Installation and Checkout 



Section 2. a COMPLETE INSTALLATION INSTRUCTIONS 

Your UltraTerm card will function properly in any of your Apple's expansion 
slots except slot 0. However, many operating systems, such as Apple 
Pascal, make certain assumptions about the use of the expansion slots. 
These assumptions are: 



Slot 



Device 






Language Card (not used in He) 


1 


Printer Interface 


2 


MODEM 


3 


External Console (UltraTerm) 


4 


Additional Disk Drives 


5 


Additional Disk Drives 


6 


First Disk Drive controller 


7 


Rigid disk controller or other interface 



Since the Pascal operating system will treat your UltraTerm as an external 
console, it must be plugged into slot #3 to work properly with that 
operating system. In deference to the users of the Pascal system, we will 
present the rest of these installation instructions as if the UltraTerm card is 
installed in slot #3. If you are going to use a different slot for your card, you 
should have no problem with the installation and testing— just remember 
to change the slot number when it is referred to in the instructions and test 
programs. 



Section 2.a.1 PRE-INSTALLATION CHECKOUT 

We carefully inspect and test each UltraTerm card before shipping it to 
your dealer. Each card is carefully packed to prevent damage during 
shipping, In spite of these precautions, you should inspect your card to be 
sure that no obvious damage has occurred in transit. 



UltraTerm card in good condition— no missing or damaged 
components, 

Apple ][ computer is operating properly. If your computer is at all 'flaky' 
or will not run Applesoft BASIC properly, it will be very difficult to verify 
proper operation of your UltraTerm card. 



Section 2.a.2 BOARD INSTALLATION 



• Turn off your Apple ][. 

• Disconnect the power cord from the back of the computer. 

• If you are using an extended memory card in the Auxiliary slot of an 
Apple lie, you must install the blue jumper plug over the upper two pins 
of J-1 . The locations of the jumper pins are shown in figure Y.1 

• Remove the lid from your Apple. Do this by placing the heels of your 
hands on the back corners of thecaseand pulling straight upon the 
back edge of the lid with your fingers until it pops loose. Lift the back 
edge about one inch then slide the lid to the rear until the front edge is 
clear of the case. You can then lift the lid free and set it aside. (If you lift 
the rear edge too far, the front edge of the lid will hit and possibly 
damage components attached to your keyboard.) 

• Locate expansion slot #3. With the keyboard nearest to you, the slots are 
numbered from to 7 with slot #0 at the left, next to the metal case of the 
power supply. (If you have an Apple //e, there is no slot #0.) There are 
slot numbers printed on the main PC board between the slots and the 
back edge of the board. 

• Press the UltraTerm card straight down into the expansion slot 
connector. When it is properly seated, the top of the card will be level 
and parallel to your Apple's main circuit board. 

Section 2.a.3 VIDEO CABLE CONNECTION 

• Locate the end of the cable that came with your UltraTerm card which 
has a male RCA Phono plug. Insert this plug into the video output socket 
on the back of your Apple ][. 

• Lead the cable into your computer through one of the slots in the back 
panel. If you have an Apple //e, you will have to remove the plastic cover 
from one of the openings in the back panel. Plug the molex connector in 
the middle of the cable onto the pins on the UltraTerm card. The 
connector is keyed so that it cannot be connected backwards. 

• Lead the remaining end of the cable out of the computer. This end has a 
female RCA phono jack. Plug the male RCA connector from your video 
display monitor into this connector. If the cable to your display monitor 
doesn't have a male RCA phono plug, you will have to purchase an 
adapter from your local computer store. 

Section 2.a-4 FINAL INSTRUCTIONS 

• Put the cover back on your Apple ][. When you insert the front edge of 
the cover under the top of the keyboard, be careful not to disturb the 
keyboard connectors. Press firmly on the back edges of the cover and it 
will snap into place. 

• Re-connect the power cable to your computer. 



Section 2.b SHORT FORM INSTALLATION CHECKLIST 

• Turn off power and remove cover from Apple ][. 

• Install jumper over upper two pins of J 1 on the UltraTerm if you have an 
Apple lie with an Apple 80-column card or extended memory card, 

• Install UitraTerm card in Slot #3. 

• Plug male RCA connector into Apple Video output. 

• Attach Molex connector to UltraTerm connector. 

• Connect display monitor to female RCA socket. 

• Replace Apple Cover and connect power cord. 

Section 2.c CHECKOUT 

This section contains some simple tests which will help you make sure that 
your UltraTerm card is working properly. The test programs are written in 
Applesoft BASIC. If you have an Apple ][ with Integer BASIC in ROM, you 
will have to load and run Applesoft. 

If you must load Applesoft from disk: 

• Put your DOS System Master Disk in your boot drive. 

• Turn on your Apple. Your disk drive should start and its 'IN USE' light 
should come on. The Hello program on the system master disk should 
load Applesoft into RAM for you. If your disk drive does not come on, 
immediately turn off the power to your Apple and refer to Chapter 3. 

• Type the 'FP' command to switch to Applesoft BASIC. 
If you have an Apple ][ Plus: 

• Open all disk drive doors. This will make sure that no auto-start files will 
be loaded. 

• Turn on your Apple. The 'IN USE' light on your boot drive should come 
on and stay on. If this does not happen and the power light on your 
keyboard does not come on, immediately turn off the power switch and 
refer to Chapter 3. 

• Press <CTRL-RESET>. 
For all users: 

• Your video display should show the Applesoft prompt (']') followed by a 
flashing cursor block. 

• Enter 'PR#3' followed by <RETURN>. You are now in the 80-column 
mode of the UltraTerm card. The 'PR#3' should be gone and you should 
see only the Applesoft prompt and a flashing cursor. 

• Type some random lines of text and look at the display on your monitor. If 
the characters do not appear as you type them, your display monitor 
may not be adjusted properly, or your video cables may be improperly 
connected. If you have a problem, do the next test before going to 
Chapter 3. 



• 



Press 'G c ' . You should hear a short beep. This beep should be a 
little lower in pitch than the beep Applesoft uses to tell you that 
you have made a mistake. If you hear this beep, it means that the 
firmware EPROM on your UltraTerm card is working properly. 
Now you can go to Chapter 3 if your display is not working 
properly. 

Enter the following program. End each line with a<RETURN>. 

10 HOME; FORN = 1 TO 100 

20 PRINT "The quick brown fox jumps over lazy dogs."; 

30 NEXT N 

40 PRINT "PRESS ANY KEY TO CONTINUE..."; 

50 GET A$: PRINT CHR$(22);"0": HGR2:HCOLOR = 3 

60HPLOT0,0TO279,191 

70 GET A$: PR#3: PRINTHOME 

80 LIST: END 

• Type 'RUN' <RETURN>. Your video display should look like 
figure 2.1 . We picked this display to allow you to adjust your 
video display monitor if necessary. A discussion of display 
monitors and their adjustment is included in Chapters three and 

nine. 

• Press the space bar on your keyboard. You should see a 
diagonal line from the upper left-hand to the lower right-hand 
corner of your display monitor. This test checks the video switch 
which automatically selects the HI-RES graphics or text display. 

• Press the space bar again. You should see the 80-column text 
screen. The program should be finished and the Applesoft 
prompt followed by a flashing cursor should be at the bottom of 
the screen. 

• Type <ESC>'3' to set the 160-column by 24-line mode. RUN the 
program again. If the characters on the left hand margin are off 
the edge of the screen, your monitor has too much overscan to 
use this mode. See chapter 9. 

• When the program ends, type<ESC>'6' to set the 80-column by 
48-line mode. RUN the checkout program (the screen will be only 
half full). If the display appears to shimmer, your monitor has a 
low-persistence phosphor. You will see this shimmer whenever 
you use the modes which utilize the interlace mode with the high- 
quality character set. 

• When the program ends, type<ESC>T to return to the 80 x 24 
mode. 

• Your initial check out is complete. You may proceed to Chapter 
Four for more complete operating instructions. 
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Figure 2.1 Sample Screen Produced By Test Program 



CHAPTER THREE 



Our many thousands of hours of troubleshooting experience with the 
Videoterm card have shown us that most problems are a result of easily- 
corrected installation errors, video monitor adjustments, or 
misinterpretation of our operating instructions. In this chapter we will help 
you diagnose problems with your UltraTerm. If you can trace the problem 
to installation, video connections or monitor adjustments, we will show you 
how to get your UltraTerm working. If you find that your UltraTerm is not 
working properly, we suggest you get help from your dealer. Your 
UltraTerm uses a multi-layer printed circuit board which allows us to put a 
lot of circuitry in a very small space. This makes servicing the board a task 
which should be undertaken only by a qualified technician. 

If you have a problem that you cannot diagnose with help from this 
chapter, please feel free to call one of our service technicians at (503) 758- 
0521 . They are available to help you from 8AM to Noon and from 1 PM to 
4;30PM (Pacific time) Monday through Friday (they do get holidays off). 



We will start with the assumption that your Apple and video monitor 
worked well together before you installed your UltraTerm. If you are not 
sure of this, turn off your Apple, remove your UltraTerm and check out your 
Apple and video monitor. If they work properly, turn off your Apple and 
install your UltraTerm (following the instructions in Chapter two). 

The next item to check is the internal video switch on your UltraTerm. Do 
you get a 40-column Apple video display when you first turn on your 
Apple? If you do, the UltraTerm video switch is properly selecting the 
Apple video signal. This means your monitor, cables and connections are 
working properly. 

Next, use the 'PR#3' 

If you now get a prompt sign, and the video display works properly, your 

second try at installation has solved your missing video problem. If your 

screen goes blank when you use the 'PR#3' 

is working. Type a few l G c> keys. You should hear a beep, about an octave 

lower than the Applesoft beep, from the Apple speaker. If you hear the 

beep, the firmware on your UltraTerm card is working. If there is no beep, 

the firmware on your UltraTerm is not executing its code properly. In either 

case, it's time to check with your dealer or call our service technicians. 



Section 3.b UNACCEPTABLE VIDEO DISPLAY 

If the display quality of your UltraTerm is not what you expect it to be, there 
are several areas you can check. The two most common problems are: 1) 
choosing a display mode unsuited to your monitor; and 2) display monitor 
improperly adjusted. 



Section 3.b.1 DISPLAY MODE AND MONITOR MISMATCHED 

Chapter Nine will tell you in detail which monitors are suitable for the 
different video modes you can use with your UltraTerm. If you are using a 
display mode which is not suited to your monitor, you will probably 
experience one of the two following problems: 

1 . Some characters are missing on the edges of the screen. You will 
probably experience this problem if you use a display such as the 
Apple Monitor /// in the 1 60-character mode. This mode uses 
more of the horizontal scan time than is displayed by the monitor. 
As a result, some of the characters are displayed before the CRT 
electron beam reaches the left edge of the screen, and others are 
displayed after the beam leaves the right edge. If you have a 
monitor with a width adjustment, you can shrink the width of the 
display until all the characters are visible. You will also experience 
this problem when you use the 96-character display mode with 
the Monitor ///. Since the Monitor /// and many other displays do 
not have an external width adjustment, we suggest you use the 
80, 128 or 132-column modes with these displays. 

2. If your display appears to shimmer or flicker when you select a 
display mode which uses the high-density character set or 
displays more than 24 lines, you probably have a monitor which 
does not have a long-persistence phosphor. In the interlace 
mode, your UltraTerm writes each scan line only one half as often 
as it does in the non-interlace mode. As a result, if your monitor 
does not retain the bright dots on the screen until the next scan, 
the display appears to flicker or shimmer. If you feel you must use 
an interlace mode, you can minimize the shimmer by careful 
adjustment of the contrast and brightness controls. In the interest 
of avoiding eyestrain, we suggest you use the non-interlace 
modes unless you have a monitor with a long-persistence 
phosphor. 



Section 3.b-2 DISPLAY MONITOR OUT OF ADJUSTMENT 

If your display monitor is out of adjustment, may want to try adjusting its 
controls to improve the display with your UltraTerm. You will generally find 
that if your monitor is adjusted for the best display with the Apple video 



signal, you will not need to make any large adjustments for the best display 
with your UltraTerm. The following adjustments may improve the display 
when you use your UltraTerm: 

1 Adjust brightness and contrast to provide adequate character 
brightness with a completely black background. The brightness 
level depends on the highlight/lowlight mode. On some displays, 
the brightness level may vary depending on the number of 
characters on the screen. Try filling the screen with characters 
and adjusting the brightness for the best display. 

2. Adjust the horizontal and vertical hold controls until your 
UltraTerm is stable and doesn't show any tearing of the first 
characters at the top of the screen. On most monitors, you should 
be able to adjust the vertical hold to make the display roll both 
upwards and downwards. Adjust this control to a point midway 
between the upward and downward rolls. If your display 
continues to roll in spite of your adjustments, switch to the Apple 
video signal. If your display still rolls, there may be a problem with 
your internal video switch. Make sure that the problem 
disappears when you connect your monitor directly to the output 
jack on the back of your Apple, then visit your dealer or call our 
service technicians. 

3. Characters which are of uneven height from the top to the bottom 
of the display can be corrected by adjusting the vertical linearity 
control. Unfortunately, on many displays such as the Monitor///, 
this control is inside the cabinet. Since there are high voltages 
present inside the cabinets of video display monitors, internal 
adjustments should be carried out only by qualified service 
technicians. 

4. Fuzzy or indistinct characters can have two possible causes. First, 
your monitor may have too little bandwidth to display the number 
of characters your UltraTerm can produce. You should have a 
monitor with a bandwidth of at least 1 5 MHz. This is particularly 
important if you are using the 1 28, 1 32, or 1 60-character modes. 
If your monitor has adequate bandwidth, but the display is still 
fuzzy, the electron beam may not be properly focused on the 
screen. Some monitors have an external adjustment which you 
may set for the best display. Other monitors, such as the Monitor / 
//, do not have an external focus control. You should take the 
monitor to your dealer for adjustment unless it is out of warranty 
and you are comfortable working with exposed high-voltage 
circuits. 

NOTE: Moving Jumper J-4 may improve the display on some monitors 
(see Appendix Y.8). 
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Section 3.c WARRANTY AND NON-WARRANTY REPAIR 

When you have a problem with a Videx product, your first step should be 
to contact your dealer. If the dealer is unable to solve the problem, please 
give our service department a call at (503) 758-0521 . Our service 
technicians can often diagnose the problem and send you a part which will 
repair your board. In this way, they can often save you the time and 
expense of sending your board in for repair 

Before you call us, please prepare a brief summary of your problem. If you 
can, please have your computer nearby and running. Our service 
technicians may be able to suggest tests which can diagnose your 
problem more completely 

If you must return your UltraTerm to us for service, the service technician 
will give you an RMA number. (RMA stands for Return Merchandise 
Authorization). You must have an RMA number for any merchandise you 
send us— whether it is still in warranty or not! You should clearly mark the 
RMA number on the outside of your package, as well as on a brief note 
included with the defective board. We use the RMA number and our in- 
house computer to monitor the progress of your board through our service 
department and to ensure the fastest possible turnaround time. 

We have included a tear-out RMA form at the back of this manual for your 
convenience. Please fill out this form and include it with your UltraTerm 
when you return it to us. This form will help you to be sure you don't forget 
any vital information— like your return address 1 . 
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The UltraTerm firmware also checks the output characters which are 
printed by programs for special control characters. For instance, when a 
program sends the <CR> or Carriage Return character, the UltraTerm 
moves the cursor to the beginning of the next line. The <CR> does not 
normally appear on the screen— even though the card can display control 
characters, they are normally swallowed by the firmware. 

The important thing to remember is that there are two ways to send 
commands to the UltraTerm card: 

1 . By entering special command characters from the keyboard. 
(Input Commands) 

2. By having a program print command characters as part of the 
program output. (Output Commands) 

You should note that certain characters are used as both input and output 
commands. Some operating systems may send all keyboard input directly 
to the output device. This is known as 'keyboard echo.' When you use a 
system like this, a command which would normally work only as an output 
command may also work as an input command. I n addition, some 
operating systems or peripheral card firmware may intercept commands 
from the keyboard and change them before sending them to the output 
device. This is done by the UltraTerm firmware. When you type the <K C > 
key, the UltraTerm will intercept the character and change it to a left 
bracket '[' before sending it to the screen. Other systems and application 
programs may make their own special changes to the input characters 
before sending them to the output device. Since we don't know what 
special programs you may be using, we can't always guarantee that a 
certain key will always produce the same result. We will tell you what will 
happen if you use the UltraTerm commands in the most common 
operating systems in the next chapter. In Chapter 7, we will tell you what to 
expect if you use some of the more popular applications programs and 
word processing systems. 



Section 4.b.1 INPUT COMMANDS 

You can send your UltraTerm an input command any time that you are 
typing characters at the keyboard. The UltraTerm will execute the 
command, but may not pass the command characters on to the program 
that was waiting for input. Since the program may not know that you have 
entered the command, you should be cautious about modifying the 
screen display. Otherwise, you may erase some necessary information 
without telling the program what you have done! If you have a program 
that must receive one of the UltraTerm input commands, you will have to 
use a special input routine which bypasses the UltraTerm firmware. 

Please note that many input commands function only with BASIC and 
DOS. Many of these commands cannot be used with Pascal and CP/M. 



Section 4.b.2 OUTPUT COMMANDS 



Your software can send commands to the UltraTerm at any time when it is 
sending characters to the screen. The command will be executed, but the 
commandcharacters may not appear on the screen. Some programs 
(such as Apple-Writer ][ when modified with our Pre-Boot disk) can cause 
command characters to appear on the screen. For example, the Apple 
Writer ][ program can display all the Carriage Return characters in a block 
of text by using the CR abbreviation character which is part of the 
UltraTerm character set. The program does this by storing the abbreviation 
character directly into the UltraTerm display RAM and bypassing the card's 
firmware. The firmware will normally execute the command and swallow 
the command character. 



Section 4.b.3 OPERATING SYSTEM COMMANDS 

The firmware on your UltraTerm card recognizes certain operating system 
commands which change the video display without sending control 
characters to the card. For example, the HOME, VTAB and INVERSE 
commands of Applesoft BASIC will work properly even though they do not 
cause any characters to be sent to the UltraTerm. 



Section 4.b.4 AUTOMATIC VIDEO SWITCHING 

Your UltraTerm contains an electronic switch that will automatically select 
the proper video signal when you change display modes. When you turn 
on or reset your computer, this switch sends the Apple's 40-column video 
signal to your display monitor. The 'PR#3' command causes the electronic 
switch to send the output of your UltraTerm to the display. We will show you 
a simple software command you can use to switch to the Apple video 
signal so that you can view the graphics display. The 'PR#3' command will 
switch you back to the video mode you were using before you switched to 
the graphics mode. The equivalent commands in other operating systems 
such as Pascal will also control the electronic switch on the UltraTerm in a 
similar manner. 



Section 4.c A SUMMARY OF THE CHAPTER 

In this chapter we introduced you to the following features of your 
UltraTerm: 

• You can use your UltraTerm without having to learn any new 
commands or operating methods. 

• You can configure your operating system to automatically use your 
UltraTerm, or you can configure it by hand at any time. 



The UltraTerm responds to command characters typed at the 
keyboard (input commands). 

The UltraTerm responds to command characters printed by 
programs (output commands). 

Command characters are normally 'swallowed' by the UltraTerm. 

Certain operating systems commands such as HOME will be 
acted upon by the UltraTerm. 

The electronic switch on the UltraTerm will automatically select the 
Apple video signal for 40-column output or graphics output. 



CHAPTER FOUR 



The Beginner's Guide 



This chapter will provide a simple set of instructions to help you get started 
with your UltraTerm. We also describe the way your UltraTerm works with 
the most-used operating systems for the Apple. 



Section 4.a WHEN YOU FIRST TURN THE POWER ON 

Since your Apple ][ or Apple ][ Plus can normally display only 40 columns 
of text, most of the programs and operating systems for your computer are 
written to use only a 40-column display. When you first turn the power on, 
your operating system (Apple DOS, Pascal or CPM) must be informed that 
you want to use the UltraTerm card. When you tell the operating system 
that you want to use a special feature, we say you are 'configuring' the 
system. There are two ways to configure an operating system or program: 

1 . By hand— each time you start up your computer or run a new 
program, you type in a command that tells the system to use the 
UltraTerm card. This is what we did when we used the 'PR#3' 
command during checkout. 

2. Automatically— you run a utility program just once which writes a 
special data file or modifies some software on your boot disk. The 
new information on the disk will automatically select the UltraTerm 
card when you boot the disk. This method is used by the Pascal 
and CPM operating systems. 

Chapter 7 contains completeinstructionsfor configuring the most 
common operating systems for the Apple. Chapter 7 will help you use your 
UltraTerm with some specific programs which can use the card. Most of 
the examples in the next chapter will use Applesoft BASIC and Apple 
DOS. 



Section 4.b NORMAL USAGE 

In normal usage, your UltraTerm can be used just like your standard Apple 
video display. Your card does have many additional features for which you 
will have to learn new commands. However, we will save these for later. 
Many new users think of the UltraTerm card as a display device only. 
Actually, the firmware program on your card works with both the keyboard 
input and the video display. When you are entering characters from the 
keyboard, the UltraTerm firmware checks for special command 
characters. If command characters are found, the UltraTerm executes the 
proper command, then 'swallows' the command sequence. Thus, when 
you enter 'A c ', the UltraTerm toggles the upper-lower case mode to allow 
you to enter lower-case characters. The 'A c ' is not sent to the screen or the 
program which is waiting for input. 



The UitraTerm firmware also checks the output characters which are 
printed by programs for special control characters. For instance, when a 
program sends the <CR> or Carriage Return character, the UitraTerm 
moves the cursor to the beginning of the next line. The <CR> does not 
normally appear on the screen— even though the card can display control 
characters, they are normally swallowed by the firmware. 

The important thing to remember is that there are two ways to send 
commands to the UitraTerm card: 

1 By entering special command characters from the keyboard. 

(Input Commands) 
2. By having a program print command characters as part of the 

program output. (Output Commands) 

You should note that certain characters are used as both input and output 
commands. Some operating systems may send all keyboard input directly 
to the output device. This is known as "keyboard echo.' When you use a 
system like this, a command which would normally work only as an output 
command may also work as an input command. I n addition, some 
operating systems or peripheral card firmware may intercept commands 
from the keyboard and change them before sending them to the output 
device. This is done by the UitraTerm firmware. When you type the <K C > 
key, the UitraTerm will intercept the character and change it to a left 
bracket '[' before sending it to the screen. Other systems and application 
programs may make their own special changes to the input characters 
before sending them to the output device. Since we don't know what 
special programs you may be using, we can't always guarantee that a 
certain key will always produce the same result. We will tell you what wil! 
happen if you use the UitraTerm commands in the most common 
operating systems in the next chapter In Chapter 7, we will tell you what to 
expect if you use some of the more popular applications programs and 
word processing systems. 



Section 4.b.1 INPUT COMMANDS 

You can send your UitraTerm an input command any time that you are 
typing characters at the keyboard. The UitraTerm will execute the 
command, but may not pass the command characters on to the program 
that was waiting for input. Since the program may not know that you have 
entered the command, you should be cautious about modifying the 
screen display. Otherwise, you may erase some necessary information 
without telling the program what you have done! If you have a program 
that must receive one of the UitraTerm input commands, you will have to 
use a special input routine which bypasses the UitraTerm firmware. 

Please note that many input commands function only with BASIC and 
DOS. Many of these commands cannot be used with Pascal and CP/M. 



CHAPTER FIVE 



In this chapter we will describe the operation of your UltraTerm and show 
you how it will respond to commands sent to it. The chapter is divided into 
sections covering input commands, output commands and special 
operating-system commands. We will also show you how to set the DIP 
switches which select the attribute sets your UltraTerm will use when you 
first turn on your computer. 



Input commands are commands which you send to your UltraTerm from 
the keyboard. The UltraTerm will not pass on the characters in the 
command to your program. The command is executed by the UltraTerm 
firmware and the command characters are 'swallowed.' All other 
characters are passed on to your program as usual. Here are the input 
commands your UltraTerm will accept: 

A c : Uppercase/lowercase toggle. This command will switch you 
from upper case input to lower case input or vice-versa. Only 
the A through Z keys on your keyboard are affected. (If you 
have a Keyboard Enhancer or Enhancer ][, you do not need 
this command and it will work properly only if your Apple is in 
the standard Apple keyboard mode. See your Enhancer 
manual for details.) This command is not needed or available 
on the Apple He. 

K c : This command will generate the '[' character. This character 
cannot be generated on a standard Apple keyboard without 
special software (like that in the UltraTerm firmware). This 
command is also not available if you have an Apple He. The '[' 
is available on the keyboard of the Apple He. 

S c - This is the pause command. This command causes output to 
the UltraTerm card to halt so that you can examine the display. 
Another *S C ' or any other character will cause the UltraTerm to 
continue. 

The firmware on your UltraTerm also allows you to type BASIC programs 
using lower-case letters (if you have an Apple He or an Apple ][ with an 
Enhancer ][). The firmware automatically translates all the input characters 
to upper case unless they are enclosed in quotation marks. When you 
LIST the program you will see the BASIC commands in upper-case letters, 
but strings enclosed in quotation marks will remain exactly as you typed 
them. 



Section 5.b OUTPUT COMMANDS 



An output command is a special character or characters which is sent to 
the UltraTerm. Instead of displaying the command, the UltraTerm will 
recognize the command and take some special action. The command 
characters are swallowed by the UltraTerm. The commands may be sent 
to the UltraTerm by your program or by the operating system. If your 
operating system (like Apple DOS) echoes input characters to the screen, 
you can perform some of these commands from the keyboard as well. 
Some of the commands contain special characters which cannot be 
generated on a standard Apple keyboard. You will need to use a CHR$(X) 
function from BASIC or theCHR(N) function in Pascal to generate the 
commands. Here are the output commands to which your UltraTerm will 
respond: 

G c : This is the ASCII bell character. It will cause a short beep from 
the Apple's speaker. The beep produced by the UltraTerm will 
be a little lower in pitch than the beep produced by the Apple 
alone. 

H c - This command will move the cursor back one space. It is also 
generated by the left-arrow key When you enter this 
command from the keyboard, the operating system usually 
deletes the character preceding the cursor from the input 
buffer. 

J c This command character is the ASCI I Line Feed. It will move 
the cursor down one line. If the cursor is already at the bottom 
of the screen, the whole screen will move up one line, and the 
cursor will stay on the bottom line. 

K c - This command will clear the display from the cursor position to 
the end of the screen. The character under the cursor will 
disappear, but the cursor will not move. 

L c : Sending this character to the UltraTerm will clear the whole 
screen and move the cursor to the uper left-hand corner. This 
is the ASCII Form Feed character. 

M 0, This character, the Carriage Return, will move the cursor to the 
beginning of the current display line. If it is sent from BASIC, a 
linefeed will also be sent. 

N c : This command selects the standard attribute set for display. 
All characters sent after this command will be displayed at 
with the default attributes (normal video and lowlight intensity, 
unless you have changed the attributes). This command does 
not function in DOS and BASIC and you should use the 
'NORMAL 1 command instead. 

O c This is the alternate attributes command. It will select the 
alternate display attributes for all characters sent after the 
command. The alternate attributes normally display inverse 
video. This command does not function in DOS or BASIC and 
you should use the INVERSE' command instead. 
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R Ci We call this the Raw Mode command. It is used to disable 
most of the special commands of the UltraTerm. After you 
send this command, the UltraTerm will respond only to G c , H c , 
J c , and M c . This command can be cancelled only with the 
'PR#3' command. 

U c : This command sets the Apple 40-column mode. The video 
switch is set to select the Apple video signal. 

V c : This command sets the video format for your UltraTerm card. 
The V c character is followed by a single digit between and 8 
which determines the command as follows: 

Set the Apple 40-column mode. The video switch is set to 
select the Apple video signal. 

1 Set the 80 x 24 video mode. This is the mode which 
emulates the earlier Videoterm cards. In this and the 
following modes, the video signal from the UltraTerm card 
is selected. 

2 Set the 96-column by 24-line display mode. This mode 
won't show all the characters on a Monitor ///, but will 
work with the NEC JB-1 201 monitor. 

3 Set the 1 60-column by 24-line mode. This mode won't 
show all the characters on a Monitor ///, but will work with 
the NEC monitor. 

4 This command sets an 80-column by 24-line mode with 
the High-Quality interlaced character set. This and the 
next four modes will show some flicker unless your 
display monitor has a long-persistence display tube like 
that on the Apple Monitor ///. With interlace on, the vertical 
elements of your characters will more completely 
connected. 

5 Set the 80 by 32 mode with interlace operation. 

6 Set the 80 by 48 mode with interlace on. (This mode does 
not use the high-quality character set.) 

7 Set the 1 32 by 24 mode with interlace on. 

8 Set the 1 28 by 32 mode with interlace on. 

W c This is the lead-in character for the command to set the video 
attributes. The W c is followed by two digits, each of which may 
range from to 7. The first digit sets the attributes which will 
be used when the high bit of the character in the display RAM 
is clear. The second character sets the attributes to be used 
when the high bit of the byte in the character RAM is set. See 
Section 8.d.3 for a discussion of video attribute programming 
and the display characteristics for each of the digits. 



Nibble 








Value 


Resulting Display Characteristics 


7 


Alternate char, set 


inverse video 


highlight 


6 


Alternate char, set 


inverse video 


lowlight 


5 


Alternate char, set 


normal video 


highlight 


4 


Alternate char, set 


normal video 


lowlight 


3 


Standard char, set 


inverse video 


highlight 


2 


Standard char, set 


inverse video 


lowlight 


1 


Standard char, set 


normal video 


highlight 





Standard char, set 


normal video 


lowlight 


Note: These nibble values are 


used with the W c command to set the 


display 


attributes. 







Y c This command will move the cursor to the upper left-hand 
corner of the display. The display will not be cleared. 

Z c : This is the lead-in for the Control-Character Display 

Command. It is followed by a single character to select the 
command. The results produced by different command 
characters are as follows: 

@ c , A c to G c Display the appropriate block graphic 
character. 

H c to P c Display symbols for ASCII control codes if using 
standard character set. If the high-quality character set is 
enabled, additional block graphics characters are displayed. 

Q c to _ c Display the appropriate line drawing character. 

Z c 1 This command switches you to the Apple 40-column video 
display. It is included for compatability with the Videoterm. 

The following commands cannot be entered from the standard Apple 
keyboard. Each command is followed by the appropriate CHR$(N) 
command as you would use it in a BASIC program. 

\ C (CHR$(28)): This command will move the cursor forward one 
space. 

] C (CHR$(29)): This is the Clear to End of Line command. All the 
characters from the cursor to the end of the current line will be 
cleared, including the one under the cursor. 

aC (CHR$(30)): This is the GOTOXY lead-in command. The two 
characters following the lead-in will determine the new 
position of the cursor. The first following character will 
determine the new horizontal position. The second will specify 
the vertical position. The position specifiers are offset by 31 , 
so the sequence CHR$(30), CHR$(64), CHR$(48) would 
move the cursor to column 33 of row 1 7. The value of x may 
range from 32 to 1 12, and the value of y may range from 32 to 
56. To move to a location determined by variables X and Y, 



you would use: 

PRINT CHR$(30);CHR$(X+31);CHR$(Y + 31); 

_ C (CHR$(31)): This is the reverse line feed command. It will 

cause the cursor to move up one line. If the cursor is at the top 
of the screen, nothing will change. 

The following short demonstration program will display the complete 
character set on the screen. It also demonstrates the use of the 'Z c ' output 
command to display the line-drawing and block graphics characters. 



10 HOME J = 1 

20 FORI =0 TO 127 

30 IF K32 THEN PRINT CHR$(26); :REM CONTROL-Z 

40 POKE 36, J * 6: PRINT CHR$(I);"-";I; 

50 J = J + 1. IF J > 1 1 THEN J = 1. PRINT PRINT 

60 NEXT I 



These commands are different from input or output commands in that they 
may not actually send characters to the UltraTerm. Or, they may require 
some additional action from the operating system to operate as expected. 
These commands function properly only in the BASIC or DOS operating 
systems. 

U c : We call this command the Copy-forward It will cause the 
cursor to move one space to the right. In addition, the 
character which was under the cursor before the move will be 
picked up from the screen and sent to the computer as if it 
had been typed on the keyboard. 

<ESC>: This is the lead-in command for the screen editing mode. The 
command is followed by one or more characters which 
determine the editing command. The valid editing commands 
are: 

Set Apple 40-column display 
Set 80 x 24 display 
Set 96 x 24 display 
Set 160 x 24 display 
Set 80 x 24 display with interlace 
Set 80 x 32 with interlace 
Set 80 x 48 with interlace 
Set 132 x 24 with interlace 
Set 128 x 32 with interlace 
Clear the screen. 
Cursor Right 



A 



B 


Cursor Left 


C 


Cursor Down 


D 


Cursor Up 


E 


Clear From Cursor to End of Line 


F 


Clear From Cursor to End of Screen 


1 


Cursor Up 


J 


Cursor Left 


K 


Cursor Right 


M 


Cursor Down 



The I, J, K, and M command characters may be repeated without entering 
another <ESC> for multiple cursor moves. The command will end with the 
first character which is not an I, J, K, or M. The cursor move keys are 
slightly different on the Apple He, which has up and down arrow keys. 
These keys will not move the UltraTerm cursor. 

HOME This command is available only in Applesoft BASIC. It clears 
the 40-column screen. The UltraTerm firmware is able to 
detect this command and wilt also clear the UltraTerm display 
and move the cursor to the upper left-hand corner of the 
screen. 

INVERSE The UltraTerm will display all following characters in inverse 
video when this command is used in BASIC. 

NORMAL All following characters will be displayed in normal (white on 
black) video. (Please note that INVERSE and NORMAL 
function in this manner only if you have not changed the Video 
Attributes Register. If you change the register, you can alter or 
even disable these commands.) 

HTAB This command will work properly only if you HTAB to a 

column between 1 and 40. HTABs past column 40 are not 
supported. We suggest you use the POKE commands 
described in Chapter 8. 

VTAB The VTAB command will work just as it does in BASIC, except 
that you cannot VTAB lower than line 24. The cursor will move 
to the line whose number follows the command. The 
horizontal position of the cursor will remain the same. 

FLASH This command will produce uncertain results when used with 
the UltraTerm. You should remove it from your BASIC 
programs before you use them with your UltraTerm. 



Section 5.d DEFAULT ATTRIBUTE SWITCHES 



The video attributes that your UltraTerm uses when your computer is 
turned on or reset are selected by four DIP switches. The first two switches 
select the attributes used when the high bit of the character is zero, and the 
second two select the attributes when the high bit is one. We call these the 
standard and alternate attribute sets. I n each of these two groups of 



switches, one selects either highlight or lowlight intensity and the other 
selects normal or inverse video. The switches are arranged as follows: 



SWITCH POSITION 
LEFT RIGHT 



Highlight 



-1- 



Lowlight Intensity 



Inverse 


-2- 


Normal 


Video 


Highlight 


-3- 


Lowlight 


Intensity 


Inverse 


-4- 


Normal 


Video 



Standard Attributes 



Alternate Attributes 



When we shipped your UltraTerm, switches 1, 2 and 3 were set in the 
RIGHT position and switch 4 was set in the LEFT position. This results in 
lowlight normal video when the standard attributes are selected and 
lowlight inverse video when the alternate attributes are selected. This will 
give you the expected normal and inverse displays when you use the 
appropriate commands in BASIC. 



reconnects the DOS I/O hooks. Here is a short 'Hello' program that will 

turn on the UltraTerm when the disk is bootstrapped. To use this as a 
'Hello' program, you would type the program into the computer, then use 
the 'IN IT HELLO' DOS command to initialize a blank disk. Be sure to clear 
any old programs from memory with a 'NEW command before you type 
in the program. 



1© PR#3: REM TURN ON THE UltraTerm 

20 CALL 1002: REM RECONNECTTHE DOS 

30 HOME: REM CLEAR SCREEN 

40 PRINT" UltraTerm IN 80-COLUMN MODE" 

50 PRINTPRINT 

60 END 



If your UltraTerm is running and you want to restart Apple DOS or 
bootstrap the system, you should first set your Apple back to the 40- 

column mode. If you don't do this, the new DOS will not send the output to 
the UltraTerm and you won't see anything on the screen unless your hello 
program turns the UltraTerm on again. You can return to the 40-column 
mode by using the keyboard command 'CTRL-RESET' 



Section 6.a.2 NORMAL USE 

Normal use of your UltraTerm doesn't demand further action on your part 
once you have used the 'PR#3' command to turn on the card. You can use 
your Apple much like you would with the 40-column display. Your 
programs may take advantage of the features of the UltraTerm by sending 
output commands to the card. However, you will probably find that the 
input commands are used most often. The following commands can be 
sent from the keyboard at any time. Most of them work in just the same 
fashion that they do on the 40-column screen. 

A c Uppercase/lowercase toggle. This command will switch you 
from upper case input to lower case input or vice-versa. Only 
the A through Z keys on your keyboard are affected. 

K c : This command will generate the '[' character. This character 
cannot be generated on a standard Apple keyboard without 
special software (like that in the UltraTerm firmware). 

S c - This is the pause command. This command causes output to 
the UltraTerm card to halt so that you can examine the display. 

N OTE : The A c and K c commands will be disabled if the UltraTerm ever 
receives a lower-case letter from the keyboard. In this case the 
firmware assumes that all the characters can be generated by the 
keyboard and these commands are not needed. 
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Some other commands, which are actually output commands, will be 
echoed to the UltraTerm by the DOS. Thus, you can use these commands 
from the keyboard as if they were input commands. The ones you will use 
most often are: 

H c " The Back-Space. It is also generated by the left-arrow key. 
When you enter this command from the keyboard, the DOS 
deletes the character preceding the cursor from the input 
buffer. 

M c This character, the Carriage Return, will move the cursor to the 
beginning of the current display line. A line feed will be issued 
automatically. 

Many of the display control and editing commands built into DOS and 
BASIC are also valid when used with the UltraTerm. 

U Ci The Copy-Forward will cause the cursor to move one space to 
the right. In addition, the character which was under the 
cursor before the move will be picked up from the screen and 
sent to the computer as if it had been typed on the keyboard. 

<ESC>: This is the lead-in command for the screen editing mode. The 
valid editing commands are: 

0-8 Set the display mode (Klines and columns) 

@ Clear the screen. 

A Cursor Right 

B Cursor Left 

C Cursor Down 

D Cursor Up 

E Clear to End of Line 

F Clear to End of Screen 

I Cursor Up 

J Cursor Left 

K Cursor Right 

M Cursor Down 

The I, J, K. and M command characters may be repeated 
without entering another <ESC> for multiple cursor moves. 
The command will end with the first character which is not an 
I, J, K,orM. 

HOME This command will clear the UltraTerm display and move the 
cursor to the upper left-hand corner of the screen. 

INVERSE The UltraTerm will display all following characters in inverse 
video. 

NORMAL All following characters will be displayed in normal (white on 
black) video. 



Section 6.b PASCAL 



The Apple Pascal operating system will automatically enable and use an 
UltraTerm card if the card is in slot #3. If the card is in some other slot, it 
cannot be used as the console device for Pascal. This is the reason that we 
have used slot #3 in all our examples in this manual. The Pascal system will 
enable the UltraTerm when it is bootstrapped. You will not need to execute 
any special commands. The SofTech P-System (An upgraded Pascal 
system offered by SofTech Inc.) will also automatically use an UltraTerm 
card in slot #3. 



Section 6.b.1 CONFIGURATION 



There is a program called 'SETUP' on the 'APPLE3:' disk of your Pascal 
system. You should execute this program, and when it asks if you have 
lower case, you should answer 'Yes' When it asks for the number of 
columns, you should answer '80' When you execute this program you will 
create a file called 'NEW MISCINFO'. After the program is finished, you 
should use the filer to delete the old 'SYSTEM. MISCINFO' file and rename 
'NEW MISCINFO' to 'SYSTEM. MISCINFO' The new parameters will be 
used the next time you bootstrap the system. Some of the system 
messages will now appear in upper and lower case letters, and the prompt 
line at the top of the screen will be expanded. The 'SETUP' program is 
completely described in Chapter 8 of the Pascal Operating System 
Reference Manual. You will need to run the program only once. You can 
then transfer the new 'SYSTEM. MISCINFO' file to any other Pascal Boot 
disks you are using. 



Section 6.b.2 NORMAL USE 



Once you have configured the 'SYSTEM. MISCINFO' file, no further 
changes to the Pascal system are needed. You will be able to use the 80- 
column display of the UltraTerm just as you did the40-column display, 
except that you will not have to bother with horizontal scrolling. In fact, the 
commands which would normally be used for horizontal scrolling are no 
longer defined. Since the system will display both upper and lower case 
letters, the Pascal Editor can now be used for word processing much more 
easily. 

The Pascal system is much more selective about which control characters 
it will echo to the screen. Thus, many of the output commands which could 
be entered from the keyboard in BASIC are not available in Pascal. If you 
try to enter a control character which Pascal does not allow, the system will 
generally echo a '?' and ignore the command. The following commands 
are strictly input commands and are available in Pascal: 
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A c : Uppercase/lowercase toggle. This command will switch you 
from upper case input to lower case input or vice-versa. Only 
the A through Z keys on your keyboard are affected. 

K c - This command will generate the '[' character. This character is 
used much more often in Pascal than in BASIC, as it is the 
character used to delimit array subscripts. 

S c This is the pause command. This command causes output to 
the UltraTerm card to halt so that you can examine the display. 

NOTE: The A c and K c commands will be disabled if the UltraTerm ever 
receives a lower-case letter from the keyboard. In this case the 
firmware assumes that all the characters can be generated by the 
keyboard and these commands are not needed. If you have an 
Apple with an Enhancer II, the'[' is generated with the<CTRL-\'> 
sequence. 

The Pascal editor will accept a number of other control characters. This 
editor is covered in more detail in the next chapter. Your own application 
programs can accept and use any control characters you want, as long as 
they are passed on by the system. The input command characters shown 
above cannot be used because they will be swallowed by the UltraTerm. 

The output commands listed in Chapter five can be used with Pascal just 
as they are with BASIC. The Pascal Editor will not allow you to directly 
embed the control characters in strings to be printed. Therefore, you will 
have to use the CHR(NN) function to print the control characters. The 
following Pascal statement would select the alternate character attribute 
set: 

WRITE(CHR(15)); {set alternate attributes 
—usually inverse video} 

Some Run-time Pascal programs such asVisiSchedule, the Wizardry 
game and early versions of PFS, will force the system to use the 40-column 
screen. Unfortunately, these programs also initialize the UltraTerm card. 
This causes the UltraTerm card to set the video switch to the 80-column 
mode. As a result, you may not see any of the output from the program. At 
this time we do not have any software patch to solve this problem. The 
newer versions of these programs are generally written to avoid this 
problem. You should contact your software supplier if your UltraTerm does 
not work properly with any of these programs. While you wait for updated 
software, all we can suggest is that you manually move the output 
connector from your UltraTerm card to the normal video output on the 
back of your Apple. 
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Section 6.c CP/M 



The CP/M operating system, when used with the Microsoft Softcard or 
other Z-80 cards, will automatically use the UltraTerm card for output. The 
UltraTerm card must be in slot #3 to be used automatically. 

You can experiment with the video format and the character attributes 
directly from the CP/M command mode. This can be done because CP/M 
will echo the UltraTerm command characters to the screen, followed by a 
question mark. The question mark appears because the UltraTerm 
commands are not valid CP/M commands. If you change the video format 
with the <V C > command, you won't see the question mark, since the 
screen will be cleared immediately. If you change the character attributes 
while experimenting, you can return to the default parameters by selecting 
a video format with the <V C > command. The firmware will select the 
default attributes when the new video format is enabled. 

Some of the output commands of your UltraTerm will not work properly 
when used directly from the CP/M command mode. This is because the 
operating system intercepts them and changes them before they are 
echoed to the terminal. The <L C > (home cursor and clear screen) 
command is a good example. The command character is intercepted by 
CP/M and changed to the Cursor Right character. The translation of 
command characters is handled by using two tables in the CP/M I/O 
configuration block. Your CP/M system comes with a utility program, 
CONFIGIO, which allows you to modify these tables. 

Some particular CP/M programs which can use UltraTerm features, such 
as Wordstar, are discussed in the next chapter. 
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Section 7.b WORDSTAR 



Wordstar comes with a configuration program called 'INSTALL' You will 
need to run INSTALL to create the proper editing environment for your 
UltraTerm. 



Section 7.b.1 CONFIGURATION 



The INSTALL program is described in the Wordstar Installation Manual. 
Appendix B of that manual has some details specific to the Apple ][. There 
are three main categories of information that are needed to INSTALL 
Wordstar: 

1 display and keyboard information 

2. printer information 

3. custom Wordstar program changes 

When asked about the display and keyboard, you will notice that you are 
given choices that include Videx cards. If your version of Wordstar does 
not include the UltraTerm as an option, then you should respond as if you 
had our Videoterm card. If you have no special keyboard hardware, you 
should select the option which specifies the UltraTerm with software U/L 
conversion. 

If you have a keyboard enhancer such as the Videx Enhancer ][ or the 
Videx Keyboard and Display Enhancer, then you should specify a 
UltraTerm with hardware U/L conversion. If you have modified your shift 
key as described in the Wordstar Installation Manual, then UltraTerm with 
shift mod option is the proper response. If you are used to using your 
<esc> key as a shift, then it is acceptable to specify the UltraTerm with 
software U/L conversion. 

The information you provide about your printer will not be affected by the 
use of the UltraTerm. Specify this information as you normally would, 

Near the end of the installation process, you will be asked 'ARE THE 
MODIFICATIONS TO WORDSTAR NOW COMPLETE?' The usual 
response is 'N\ This will invoke the 'patcher' The patcher is described in 
the Wordstar Installation Manual. The patcher will ask for addresses of 
data which need to be changed, and for new data to put in those 
addresses. The following table contains the patches you will have to make 
to use the 80 x 48 mode: 



Address 




Data 


248 




30 sets 48-line mode 


284 




2 


285 




1B 


286 




28 


28B 




2 


28C 




1B 


28D 




29 





(Entering 


a zero tells the patcher that you are finished. 



After you are done with the patcher, INSTALL will go to its normal 
confirmation and termination messages. 

If, in the future, you wish to turn off alternate characters, then simply 
change address 284 and 28B to both be 0. 



Section 7.b.2 NORMAL USE 

Wordstar for the Apple ][ was written with 80-column output in mind. This 
means that most of the "normal use" information in the Wordstar manual is 
valid, one feature which does need to be remembered is the proper way to 
toggle between uppercase and lowercase. 'A c ' will not work with 
Wordstar. Wordstar has its own mechanism for changing case using the 
<ESC> key. There is also a shift key modification described in the 
Wordstar documentation. You may also use a Videx Enhancer ][ for true 
typewriter-like operation. 

NOTE: If you configure Wordstar for a non-standard operating mode, such 
as 80 x 48, you must first set that same format in the CP/M command 
mode with a<V c 6>. 



Section 7.c APPLEWRITER ][ PREBOOT 

We will be offering a preboot diskette for the Applewriter ][ word 
processing program. At press time for this manual, the exact specifications 
for this program have not been finished. We expect that the 256-byte 
addressing mode and enhanced display quality of your UltraTerm will 
combine to make the combination of Applewriter ][, Preboot and UltraTerm 
a very attractive word processing package. 

The Applewriter preboot disk will allow you to select one of three modes 
using 24, 32 or 48 lines by 80 columns. The Preboot will work either with 
Applewriter '][ or Applewriter He. On the Apple lie you may also use an 
extended memory card if you have one installed. Please note that using 
the extended memory will slow the response of the program to keyboard 
input. If you find that the keyboard response is too slow with the 32 or 48- 
line formats, you should use the 24-line format. 
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CHAPTER EIGHT 



The Programmer's Guide 



This chapter will help you to write and modify programs to take advantage 
of the features of your UltraTerm. The programming techniques which you 
can use with each language will be explained and we will show you 
examples of some of the more important ones. 



Section 8.a GENERAL CONSIDERATIONS 

When you want to use the special features of your UltraTerm, you should 
normally activate them with the output commands described in Chapter 5. 
In some special cases, you may want to use one of the other two methods 
of controlling your UltraTerm. These two methods are language-specific 
commands and 'PEEK 1 and 'POKE' statements. Some languages, such 
as Pascal, may place very strict limitations on how you can use these latter 
two methods. Most general-purpose computer languages and many 
applications programs will allow you to control your UltraTerm by sending 
it output commands. The next three sections of this chapter will show you 
how to use the features of your UltraTerm in the three most common 
programming languages on the Apple: BASIC, Pascal and Assembly 
Language. Since the Apple FORTRAN language uses the Pascal 
operating system, the methods we will describe for Pascal can be used 
with FORTRAN. Of course, you will have to use FORTRAN output 
statements within your programs, but the other elements of the operating 
system, such as the Editor and Filer program, are the same as those used 
with Pascal. 



Section 8.b APPLESOFT AND INTEGER BASIC 

In this section we will examine the features of your UltraTerm that can be 
used with the two versions of BASIC that are available on your Apple. 
There are some differences in the command structures of the two versions 
of BASIC. Where these differences will affect your use of your UltraTerm, 
we will explain the differences. The largest difference is that there are more 
commands available in Applesoft. So, quite often, we will have to tell you 
that a command won't work with Integer BASIC. Where possible, we will 
give you another way to get the same result. 



Section 8.b.1 ACTIVATING YOUR ULTRATERM 

The simplest way to activate your UltraTerm is to use the 'PR#3' before you 
start running your program. If your Apple is displaying the BASIC prompt 



(either the ']' in Applesoft or the '>' in Integer BASIC) you can simply enter 
the 'PR#3' command and not have to worry about re-connecting DOS. 

if you want to have the 'HELLO' program on your boot disk activate your 
UltraTerm, you will have to use a slightly different procedure. When the 
'PR#3' command is used within a program, it will disconnect DOS. If you 
later use a DOS command without re-connecting DOS, you will get a 
'SYNTAX ERROR' message. The following line will activate your UltraTerm, 
then re-connect DOS: 



10 PR#3 : CALL 1002 : REM ACTIVATE UltraTerm 
AND RECONNECT DOS 



Of course, you do not need to add the REM statement to make the 
program line work, but it will certainly make your programs easier to 
understand. 

When you use the 'PR#3' command, your UltraTerm firmware will also 
simulate an 'IN#3' command. Thisallowsyou to use the input commands 
such as the S c (the output pause command) from your keyboard. You will 
never need to use the 'IN#3' command in your programs. 



Section 8.b.2 ULTRATERM OUTPUT COMMANDS 

All of the output commands we described in Chapter Five work with both 
versions of BASIC. You can include these commands in your programs 
using PRINT statements to send the commands to your UltraTerm. 



Section 8.b.3 TEXT MODE COMMANDS 

Both Applesoft and Integer BASIC have several built-in commands you 
can use to control the text display. We have listed these commands along 
with any new information you will need to use them with your UltraTerm. 

FLASH This command will not work with your UltraTerm. if you use it 
by accident, you will get an unreadable display because 
BASIC will change the ASCII codes which are sent to the 
UltraTerm. 

HOME You will not have to change this command in your BASIC 
programs. It will work just as it does with the 40-column 
display; the cursor will move to the upper left-hand corner and 
the display will be cleared. This command is not available in 
Integer BASIC, but you can simulate it with a 'CALL -936'. 

HTAB There are some limitations to the way you can use this 

command with your UltraTerm. You can HTAB only in the 
forward direction and you cannot HTAB past column 40. We 



recommend you use the 'POKE 36, HT' command where HT 
is the column number to which you want to move the cursor. 
This alternative command is also limited to movement in the 
forward direction. 

INVERSE This command will function properly with your UltraTerm. 

NORMAL This command will switch back to normal (white on black) 
video if you have used the INVERSE command. 

POS This command does not work with the UltraTerm. You should 

use the 'PEEK' command as described in section 8b. 5. 

PRINT The use of commas and semicolons for print formatting is fully 
supported by your UltraTerm. The 'PRINT TAB(HT);X1 ' will not 
work with your UltraTerm. 

SPC This command works properly with your UltraTerm. 

VTAB This command will work properly as long as you VTAB to a 
line number less than 25. If you are using the 48-line mode, 
you should use the 'POKE' commands described in section 
8.b.5 to move to lines on the lower half of the screen. 

These Applesoft commands provide a convenient way for you to 
experiment with the character attributes available with your UltraTerm. You 
can use the INVERSE, NORMAL and <CTRL>'V commands directly from 
the keyboard to change the attributes of displayed characters. For a more 
complete discussion of the programming of the character attribute register 
see section 8.d.3. 

The Apple BASIC manual mentions several monitor ROM routines which 
can be used to control the screen display by using CALL statements. Most 
of these routines (except the CALL -936 mentioned above) will not work 
with your UltraTerm. Indeed, some of these routines may cause 
unexpected results with your UltraTerm. You can use the UltraTerm output 
commands to get the same results that are produced by these 'CALL 
commands. 



Section 8.b.4 GRAPHICS MODE COMMANDS 



Before we start describing the Apple graphics mode commands, we 
would like you to note that we are not going to be describing the line 
drawing and block graphics characters included in the UltraTerm 
character set. These special characters are discussed in Appendix B. 
The Apple graphics mode commands will not automatically switch the 
video display to the Apple video signal. To display the graphics screens 
you must use the 'V c -(3' command to turn the Apple video back on. You 
can then select the appropriate graphic mode with the 'HGR', HGR2' or 
'GR' command. Once you have selected the Apple video signal, you can 
use the commands listed in your Apple manuals to set the appropriate 
graphics mode. To return to the UltraTerm text mode you must use the 
'PR#3' command. This command will switch the video signal back to your 



UltraTerm. The cursor may not be where you left it, but any special display 
modes will still be selected. In particular, if the 48-line mode was selected 
and the cursor was positioned below line 24, the cursor will be moved up 
to line 24 when you switch from graphics to text mode. 



Section 8.b.5 SCREEN CONTROL WITH 'PEEK' AND 'POKE' 

The 'PEEK' and 'POKE' commands in BASIC can be used to control some 
of the operations of your UltraTerm. The Apple 40-column screen will allow 
you to set text windows by poking the window values into locations 32 
through 35. These locations are not used by your UltraTerm firmware. In 
addition, since your UltraTerm uses a fast hardware scrolling method, you 
cannot set text windows on the UltraTerm display. 

Your UltraTerm will support some of the methods of determining and 
altering the cursor position. However, your UltraTerm uses its own special 
memory locations to store the cursor horizontal and vertical positions. 
When you want to determine the cursor position, we recommend that you 
examine these locations. For a UltraTerm in slot #3, these locations are: 



Cursor Horizontal— PEEK(1 395) 
Cursor Vertical— PEEK(1 523) 



Examining the normal cursor horizontal and vertical locations (36 and 37) 
may not give you the right result if the cursor is outside the standard Apple 
text window. 

You can use 'POKE 36, CH' and 'POKE 37, CV commands to move the 
UltraTerm cursor anywhere on the display screen. A 'POKE 36, CH' will 
move the cursor to column CH. Using ' POKE 37, CV moves the cursor to 
line CV. You should note that the cursor displayed on your screen will not 
move until you actually print a character. If you want to move the cursor 
without displaying anything on the screen, you can print an ASCII 
<NULL> command (CHRS(O)) after you have POKED the new values into 
the cursor locations. This character will not change any of your UltraTerm 
settings and will not show up on the screen. 



Section 8.b.6 DIRECT KEYBOARD INPUT 

You may find that there are times when you want to accept input directly 
from the keyboard with your programs. You can monitor the keyboard 
directly from BASIC with the following routine: 



10 REM * SUBROUTINE TO GET A CHARACTER A 

20 LET KEY = PEEK(-16384): REM LOOK AT KEYBOARD 

30 IP KEY < 1 28 THEN 20: REM REPEAT UNTIL KEY PRESSED 

40 POKE -16368,0: REM CLEAR KEYBOARD STROBE 

50 LET GC$ = CHR$(KEY-128): REM GC$ = INPUTCHARACTER 

60 RETURN 



Section 8.c PASCAL 

You can use all of the features of your UltraTerm with the Apple Pascal 
operating system. However, due to the more structured nature of this 
system, using some of the card's features requires more advance planning 
and careful programming. In this section we will show you how to 
configure the operating system to take advantage of the special features of 
your UltraTerm and how to use the UltraTerm commands within your 
programs. 

We would like you to note that many of the examples that we will give are 
not complete programs, but only code segments that you can insert into 
your own program. These code segments cannot be compiled and 
executed by themselves. We will have to assume that you are familiar with 
the Pascal system and can use the Editor and other operating system 
programs to add these code segments to your own programs. 



Section 8.C.1 INITIALIZING THE ULTRATERM 

Your UltraTerm card will be automatically activated by the Pascal operating 
system if it is installed in slot #3. This is the reason we have used slot #3 for 

all of our programming examples. Once the card has been activated, the 
operating system will no longer allow you to switch to the Apple's 40- 
column text display. Thus, you should not use the 'V c -0' output command 
to disable your UltraTerm. If you do use this command, you will have to re- 
boot your Pascal system. When the Pascal system enables your UltraTerm, 
it will automatically set the electronic switch to select the video signal from 
the UltraTerm. 



Section 8.C.2 DISPLAY MODES AND SYSTEM. MISCINFO 

When your Pascal system is initialized, it reads the characteristics of the 
system console (the keyboard and video display) from a file called 
SYSTEM. MISCINPO on the boot disk. The data in this file when you first 
get your Pascal system is configured to operate the UltraTerm in the 80- 
column by 24-line mode. There is a program on your APPLE3 disk which 
will allow you to change the information in the SYSTEM. MISCINFO file. 
This program is called SETUP 



If you want to use your UltraTerm in one of the other display modes (80 x 
48, 1 32 x 24, or 1 60 x 24). you must do three things: 

1 . You must change the information in the SYSTEM. MISCINFO file to 
match the new mode. The parameters you must change are the 
Screen Width and the Screen Height. This is done by X)ecuting 
the SETUP program 

2. You must re-initialize the Pascal system so that the new values for 
screen height and width will be read from the 

SYSTEM. MISCINFO file. This can be done by using the Initialize 
command of the operating system. 

3. Next, you should select the new display mode by transmitting the 
appropriate output command ('V c -4' etc.) to the UltraTerm with a 
simple program. You cannot use the input commands ('ESC-4' 
etc.) because the Pascal system does not allow the use of these 
commands. 



Section 8.C.3 ULTRATERM OUTPUT COMMANDS 

Output commands can be sent directly to your UltraTerm with the 'WRITE' 
and 'WRITELN' commands. The 'CHR' function is used to send control 
characters in the same way that the 'CHR$' command is used in BASIC. 
All of the output commands which can be used in BASIC are also available 
in Pascal. However, many of the commands will seldom be used directly 
because Pascal has its own built-in functions to accomplish the same 
tasks. An example is the 'GOTOXY' procedure which can be used to move 
tne cursor instead of the UltraTerm 'CHR(30)' command. You should note 
that Pascal will not allow you to enter the control codes for commands 
directly into the strings used in 'WRITE' commands. The control 
characters will not be accepted by the Pascal Editor when you write the 
program. This forces you to use the 'CHR' function when you write your 
programs. Here is a sample program which can be used to select one of 
the alternate video modes: 



Program Setmode; 

{ This is a program to select one of the alternate video modes on the 
UltraTerm card. It does not alter the SYSTEM. MISCINFO file. } 

Var Selection:char; 

Begin 

Repeat 

Page(Output); {Pascal equivalent of BASIC 'HOME 1 } 

Gotoxy(10,5); 

Writeln('* * * UltraTerm Alternate Display Mode Selection *** 

Wnteln; 



Writeln('You may select one of the following modes: '); 
Writeln(' 1 80 x 24, non-interlace (normal mode)'); 

2: 96 x 24, non-interlace'); 

3; 160 x 24, non-interlace'); 

4. 80 x 24, interlaced'); 

5:80 x 32, interlaced'); 

6:80 x 48, interlaced'); 

7- 132 x 24, interlaced'); 

8; 128 x 32, interlaced'); 



Writeln( 

Writeln( 

Writeln( 

Writeln( 

Writeln( 

Writeln( 

Writeln( 

Writeln; 

Write(' Enter your selection by number '); 

Write(" or enter "E" to exit: '); 

Repeat 

Read(Keyboard, Selection); 

Until Selection in ['V, . '8', 'E'/e']; 

{ Now send control characters to select mode— just send 
Control-V followed by the Selection character!} 

If Selection in [T.,'8 1 ] then Write(Chr(22),Selection); 

Until Selection in ['E'.'e']; 

End. 



Section 8.C.4 PASCAL-SPECIFIC COMMANDS 

The Apple Pascal language has several built-in commands that allow you 
to use the features of your UltraTerm without special programming 
techniques. Here is a list of those commands and their operation with your 
UltraTerm; 

Page(Output); This command will clear the video display and 
move the cursor to the upper left-hand corner. 

GotoXY(XX,YY); This will move the cursor to column XX and line 
YY. XX and YY must be integers and must be within the screen 
width and height values set in SYSTEM. MISCINFO. 

GRAFMODE; This command is part of the Turtlegraphics unit in 
the System Library. This will reserve the memory space for the 
hi-res graphics display. With an Apple 40-column display, it 
would also switch to the graphics video output. With your 
UltraTerm you will also have to use the statement 

Write(Chr(22),'0); 

to switch the video output to the Apple video signal. 



TEXTMODE; This command, also part of the Turtlegraphics unit, 
normally returns you to the text display. This command does 
not work properly with the UltraTerm, since it uses an 
electronic switch which your UltraTerm does not use. With 
your UltraTerm you can return to the text display at any time 
by simply writing any character to the display. The statement 

Write(CHR(0)); 

would switch you back to the UltraTerm text display. 



Section 8.d ASSEMBLY LANGUAGE 

This section will give you an introduction to the techniques you can use to 
program your UltraTerm in assembly language. For more detailed 
information on the theory of operation, memory usage and CRTC register 
usage, you should see the appendices. 



Section 8.d.1 INITIALIZING THE ULTRATERM 

You can use the following routine to switch from the Apple 40-column 
display to the default 24-line by 80-character display: 



LDA #$00 ASCII NULL CHARACTER 

JSR $C300 UltraTerm INITIALIZATION 

JMP $03EA RE-CONNECT DOS, THEN 

RETURN 



We strongly suggest that you use this routine to initialize your UltraTerm, 
rather than directly programming the CRTC registers. We have spent a lot 
of time determining the proper values for the registers in each mode. We 
would like to keep you from duplicating this effort needlessly. After you 
have called this subroutine and returned to your own program, the 
UltraTerm will be initialized, the video signal switched to the UltraTerm and 
the screen will be cleared. The DOS I/O hooks will be set up and all DOS 
files will be closed. 



Section 8.d.2 SIMPLE INPUT AND OUTPUT 

The easiest way to get a keyboard entry is to call the 'RDKEY' routine in 
the monitor ROM. This routine is located at SFDOC. This routine will allow 
the 'CTRL-A' input routine for switching between upper and lower-case 
input to work properly. The ASCII code for the key pressed will be returned 



in the accumulator. If you wish, you can write your own input routines 
which directly manipulate the Apple keyboard I/O locations. If you do this, 
you will have to write your own routines to simulate the UltraTerm input 
commands. 

To send a character to the UltraTerm, place the ASCII code in the 
accumulator and call the 'COUT' routine in the Apple monitor ROM. This 
routine is located at SFDED. Thefollowing routine shows how you could 
use this routine to set the 24-line by 1 32-character display mode: 



SET 132 



LDA #22 
JSR $FDED 
LDA #'2 
JMP$FDED 



LOAD CTRL-V 
OUTPUT VIA COUT 
MODE 2 FOR 24 x 132 
OUTPUT VIA COUT AND 
RETURN 



Section 8.d.3 MEMORY USAGE AND CRTC PROGRAMMING 

Your UltraTerm uses eight slot-dependent storage locations in the 40- 
column screen memory area. These locations are used to store variables 
used in the firmware routines. You can examine these locations in your 
assembly-language programs to determine the status of your UltraTerm. 
These storage locations (for card in slot #3) are used as follows: 



Address Name 



Usage 



$047B 


BASEL 


$04FB 


BASEH 


$057B 


CHORZ 


$05FB 


CVERT 


$067B 


BYTE 


$06FB 


START 


$077B 


POFF 


$07FB 


FLAGS 



Low byte of screen base address 
High byte of screen base address 
Cursor horizontal position 
Cursor vertical position 
I/O Byte for Pascal entries 
(Screen start address)/1 6 
Power-Off flag and Lead-in counter 
General-purpose flags register 



Your UltraTerm also uses the sixteen addresses beginning at $C0B0 to 
control the operation of the card. Some of these addresses are write-only 
locations, others may also be read, however, the data byte that you read 
has nosignificance. It is the reading of a particular address that will set a 
specific operating mode. The following table defines the control registers 
for a card in slot #3: 



Address 



Read 



Write 



SC0B0 Select character RAM 
Page© (51 2-byte mode) 

$C0B1 No Effect 

$C0B2 No Effect 
$C0B3 No Effect 

$C0B4 Select Character RAM 
Page 1 (512-bytemode) 

$C0B8 Select Character RAM 
Page 2 (512-bytemode) 

$C0BC Select Character RAM 
Page 3 (512-bytemode) 



Select UltraTerm video, 
Select CRTC register # 

CRTC data written to 
selected register 

Mode Control Port 

Video Attribute Register 

No Effect 

No Effect 

No Effect 



Reading or writing to addresses marked 'No Effect' will have no 
predictable effect on the operation of your UltraTerm. However, it may 
have unpredictable effects! We recommend that you read and write only to 
the device control addresses as we have defined them. If you mis-use 
them or use addresses not defined in the table, you may get puzzling or 
frustrating results. 

The Mode Control Port ($C0B2) is used to set the operating mode of your 
UltraTerm. Setting and clearing the bits in this port control the operation of 
the card as defined in the following table: 



Bit 

7 
6 

5 

4 

3 
2 
1 




Function 

Firmware Page Select 

Video Signal Select 
1 = UltraTerm 

Clock Frequency 

1 =28.7595,0 = 17.430 MHz 

Character Address Format 

1 = 256-Byte Pages, = 51 2-Byte Blocks 

Character RAM Address bit 1 1 (256-byte mode) 
Character RAM Address bit 1 (256-byte mode) 
Character RAM Address bit 9 (256-byte mode) 
Character RAM Address bit 8 (256-byte mode) 
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The Character Attribute Register (SC0B3) is used to set the display 
attributes for the characters stored in the display RAM. Each character 
may be displayed on the screen with one of two sets of attributes. One set 
will be selected if the high bit of the character in the RAM is set, the other if 
the high bit is clear. A set of attributes is selected by combining the 
following characteristics: 



Bit 2— Standard or Alternate Character Set 

Bit 1— Inverse or Normal Video 

Bit 0— Highlight or Lowlight Dot Intensity 



When you write a byte into the Attribute Register, the high nibble (bits 4-7) 
sets the attributes for characters with the high bit set. The lower nibble sets 
the attributes for characters with the high bit clear. Only the lower three bits 
of each nibble are significant, as there are only three possible attributes for 
each character. The following table shows the attributes you will get for a 
particular nibble written to the attribute port: 



Nibble 


k 






Value 


Resulting 


Display Characteristics 


7 


Alternate char, set 


inverse video 


highlight 


6 


Alternate char, set 


inverse video 


lowlight 


5 


Alternate char, set 


normal video 


highlight 


4 


Alternate char, set 


normal video 


lowlight 


3 


Standard char, set 


inverse video 


highlight 


2 


Standard char, set 


inverse video 


lowlight 


1 


Standard char, set 


normal video 


highlight 





Standard char, set 


normal video 


lowlight 


NOTE: 


These NIBBLE values are used with the W° command 


to set the display attributes. 







For a more complete description of the way the device control locations, 
mode control port, and video attributes function, you should consult the 
appendices. 



CHAPTER NINE 



The Hardware Interface 



In this chapter we will describe the requirements for the video display 
hardware you will need to take full advantage of your UltraTerm card. We 
will also discuss the compatibility of your card with other peripherals you 
may have plugged into your Apple. While we have tested the UltraTerm 
with many of the cards and programs available for the Apple, we cannot 
guarantee that we have tested the particular combination of peripherals in 
your computer. If you discover any problems or unusual interaction 
between your UltraTerm and other cards in your Apple, please contact our 
customer support department. 



Section 9.a VIDEO DISPLAY MONITORS 

If you are going to be completely satisfied with your UltraTerm, you must 
use it with a compatible video display monitor. There are two primary 
requirements you need to consider when selecting a video display. They 
are the video bandwidth or resolution of the display and the persistence of 
the phosphor used on the display screen. 

Your UltraTerm requires a monitor with a minimum bandwidth of 1 5 mHz to 
produce a sharp display in the 1 28, 1 32 or 1 60-character per line modes. 
When you are using these modes, your UltraTerm is using a 28-mHz clock 
to send the display dots to your monitor. This frequency is about 1 .6 times 
greater than the clock frequency used in the 80-column mode. As a result, 
many of the display monitors which provide reasonable results in the 80- 
column mode may not work well in the wider display modes. We have 
done all we can to minimize the requirements for the video monitor, but 
there is simply no way we can make the 1 60-column display work on some 
monitors. 

The interlaced display mode used to display 32 or 48 lines of text on your 
display writes the characters to the display only thirty times per second. 
This is half the scan rate used in the 24-line modes. As a result, if you use a 
monitor with a low-persistence phosphor, you may notice a shimmer or 
flicker of the image on the screen. This flicker can be eliminated by using a 
display screen with a phosphor which continues to emit light for several 
milliseconds after it has been scanned. Phosphors of this type are called 
'long-persistence' The phosphor on the Apple Monitor /// has sufficient 
persistence to eliminate flicker in the 32 and 48 line modes of your 
UltraTerm. 

Many video display monitors actually sweep the electron beam which 
lights up the phosphor dots past both edges of the display screen. This 
extended sweep is called 'overscan' If your display monitor has excessive 
overscan, it may not show all the characters at the beginning or end of a 
display line. Your display will look as if your screen is providing a window 
into another display several inches wider. In particular, we have noticed 



that the overscan on the Apple Monitor /// makes it impossible to display all 
the characters in the 1 60-character per line mode. This is in spite of the fact 
that the monitor has more than adequate bandwidth. In defense of the 
Monitor /// and other monitors which have some overscan, we should note 
that a reasonable amount of overscan is very helpful in reducing distortion 
at the edges of the screen. 

On some display monitors, you may reduce the overscan by reducing the 
width of the display. You will have to make your own decision about any 
tradeoffs between increased display width and increased distortion. 

While testing various display monitors with the UltraTerm we have arrived 
at the following conclusions: 

Apple Monitor /// An excellent overall display, it will allow you to 
use all the display modes except the 24-line by 1 60-character 
mode and the 24 x 96 mode. The Monitor /// is our choice as 
the best monitor to use with the UltraTerm. 

NEC JB-902M This 9-inch display has adequate bandwidth to 
display all the video modes of the UltraTerm. The monitor has 
minimal overscan and can display a full 1 60-character line. 
Many users will find the display too small for comfortable use 
with either the wider displays or the 48-line mode. The monitor 
also has a short-persistence phosphor which results in a 
noticeable shimmer with the interlaced display modes. 

NEC JB-1201M This 12-inch monitor has the same characteristics 
as the 9-inch JB-902M 

Leedex Video 100 This was one of the first display monitors 

available at a reasonable price. While it may be adequate for 
the 80-column modes, the resolution is only just acceptable 
for the 1 32 and 1 60-character modes. The phosphor has a 
short persistence and is not suitable for the interlaced display 
modes. 

Amdek 300A This 1 2-inch monitor has a long-persistence amber 
phosphor. The scan limits are set up so that you can use any 
of the display modes of your UltraTerm. The characters 
displayed are sharp and clear. An excellent monitor. 



Section 9.b MODEMS AND COMMUNICATIONS PROGRAMS 

Your UltraTerm is compatible with all the modems and communications 
programs we have tested. The DC Hayes Micromodem ][ firmware will 
work with your card, but it will not provide nearly as much control and 
operating convenience as a good data communications program. We 
particularly recommend ASCII Express, PRO version by Southwestern 
Data Systems. Your UltraTerm should have no problems with other cards 
which follow Apple's peripheral card protocols 



Section 9.c PRINTERS AND PRINTER INTERFACES 

Your UltraTerm should co-exist peacefully with your printer interface. Some 
printer interfaces may not correctly format data sent to the screen as well 
as the printer— particularly when print formats more than 40 columns wide 
are used. The VIDEX Serial/Parallel card is one interface which will allow 
you to use the full display width of your UltraTerm while echoing printed 
characters to the screen. Furthermore, the 132-character display mode of 
your UltraTerm will simplify the design and previewing of forms which will 
be printed on 15-inch paper or with compressed print on 8-V2 inch paper. 
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APPENDIX A 



Character Code 



THE ASCII CHARACTER CODE CHART (7 & 8 BITS) 



Decimal: 





16 


32 


48 


64 


80 


96 


112 


or; 


128 


144 


160 


176 


192 


208 


224 


240 




Hex: 


$00 


$10 


$20 


$30 


$40 


$50 


$60 


$70 




or: 
$0 


$80 


$90 


$A0 


$B0 


$C0 


$D0 


$E0 


$F0 





@° Nul 


P c Die 







@ 


P 


* 


P 


1 


$1 


A c Soh 


Q c Dd 


j 


1 


A 


Q 


a 


q 


2 


$2 


B c Stx 


R c Dc2 




2 


B 


R 


b 


r 


3 


$3 


C c Etx 


S c Dc3 


H 


3 


C 


S 


c 


s 


4 


$4 


D c Eot 


T c Dc4 


$ 


4 


D 


T 


d 


t 


5 


$5 


E c Enq 


U c Nak 


% 


5 


E 


U 


e 


u 


6 


$6 


F c Ack 


V c Syn 


& 


6 


F 


V 


f 


V 


7 


$7 


G c Bel 


W c Etb 




7 


G 


w 


g 


w 


8 


$8 


H c Bs 


X c Can 


( 


8 


H 


X 


h 


X 


9 


$9 


l c Ht 


Y c Em 


) 


9 


I 


Y 


i 


y 


10 


$A 


J c Lf 


Z c Sub 


i|c 




J 


2 


J 


z 


11 


$B 


K c Vt 


[ c Esc 


+ 


• 


K 


[ 


k 


{ 


12 


$C 


L c Ff 


V Fs 






L 


\ 


I 


I 


13 


$D 


M c Cr 


) c Gs 


- 


= 


M 


] 


m 


} 


14 


$E 


N c So 


^ c RS 






N 


/\ 


n 


*-s» 


15 


$F 


O c Si 


_ c Us 


/ 


? 










rub 



HOW TO READ THE ASCII CHARACTER CODE CHART 



The ASCII value of any character in the chart may be determined by 
adding the value at the top of its column with the value to the left of its row. 
The table may be used to find values in either decimal (base ten) or 
hexadecimal. The first two columns of characters are the control 
characters. They are followed by their ASCII names. 

Example: A control G is represented by: G c Bel. "Bel" is a short hand 
notation for "bell", meaning the bell character. Its ASCII value is $7 or $87 
(hexadecimal) or 7 or 1 35 (decimal). 



APPENDIX B 



Character Sets 



This Appendix shows the two character sets that come with your 
UltraTerm. The figures were originally printed by dumping an image of the 
High-Res graphics screen to an Epson MX-80 printer. The High-Res 
screen displays were produced by the font editor we use to design 
character sets. Since the proportions of the printout may not match the 
proportions of your screen, you may find that the characters on your 
screen look somewhat different. 



Section B. 1 THE STANDARD CHARACTER SET 

Figure B.1 shows the standard character set. This character set does not 
require interlace except when 48 lines are displayed. The hexadecimal 
value for the character code can be determined by combining the value 
along the left side of the figure with the value over the character. For 
example, the code for the capital 'P' is hexadecimal 50. Note that the 
values from $10 to $1 F contain eight block graphic characters and eight 
ASCII symbols. This character set uses a dot matrix which is 9 dots wide 
and 12 dots high. 

NOTE: In both character sets, the character with code (ASCII NUL) 
must not have any bits set. This is a required to maintain proper video 
levels during the video blanking interval. 





012345 6789ABCDEF 





--■-:ii***tt*fQi 


1 


' - L i 1 rh J " x ilTt 


2 


\ " n $ % & '<>#+,-. / 


3 


12 3 4 5 6 7 8 9: ;,:=>? 


4 


0ABCDEFGHIJKLMNO 


5 


PQRSTUVWXYZC\]-_ 


6 


^abcdefghi j k 1 rn n o 


7 


pqrstuvwxyz-C l } ~ % 



Figure B. 1 Standard Character Set 
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Section B.2 THE HIGH-QUALITY CHARACTER SET 

The High-Quality Character Set, which uses a 9 x 16 dot matrix, is shown 
in Figure B.2. Please note that this character set includes sixteen block 
graphics characters and sixteen line-drawing characters. The ASCII 
symbols are not part of this character set 





12 3456709ABCDEF 





--■-:■■_::!■!■■ 


I 


■' - L i lrh J -- L ilTt 


2 


r " tt $ X <L J ():♦:+,-, / 


3 


0123456789: ;< = >? 


4 


QflBCDEFGHI JKLNHQ 


5 


PQRSTUVWXYZ[\]^_ 


5 


abcdefglii jklrnno 


7 


pqrstuvwxyzf ! }^% 



Figure B.2 High Quality Character Set 





















fill 


Section B.3 EUROPEAN CHARACTER SETS 


Your UltraTerm can be equipped with special character set EPROMS to 
allow you to display characters used in many European languages. These 
characters sets are an option which you must purchase either from your 
dealer or directly from us. The languages supported and the characters 
which are different from the normal ASCII character set are shown in figure 
B.3. 


Standard Character Set 
















f«lj 


HEXADECIMAL 


23 40 


5B 


5C 5D 


60 7B 7C 7D 7E 




ENGLISH (UK) 


£ @ 


c 


\ 3 


*. 

K 


i 


1 
1 

6 


> 
ii 


f3 1 


^« jfl 


GERMAN 


A 


U 


FRENCH 


£ a 


o 


9 § 


K 


G 




e 


"" 




ITALIAN 


£ § 


o 


9 e 


U 


% 

a 


6 


e 


1 




SWEDISH 


tt 


A 


A 


i 


a 


6 


3t 


*Vr 




SPANISH 


£ § 


i 




L 


o 




9 


*Vr 




High Quality Character Set 


















HEXADECIMAL 


23 40 


5B 


5C 5D 


60 7B 7C 7D 7E 




ENGLISH (UK) 


£ G C \ ] 


l 


{ 


i 


} 


■"ir 




GERMAN 


ft § 


A 


o u 


I 


a 





ii 


13 




FRENCH 


£ a 


o 


9§ 


I 


■r 

e 


u 


e 


■ ■ 




ITALIAN 


£ § 


o 


9 e 


U 


a 


O 


e 


1 




SWEDISH 


tt <? 


II 

A 


ofi 


i 


a 


■ ■ 




a 


■"ir 




SPANISH 


£ § 


■ 


N 6 


i 


o 




9 


■"lt 




Figure B.3 European Character Sets. The alternate characters for 
each language are shown under the hexadecimal value 
for the character. 
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APPENDIX C 



CRTC REGISTERS 



This appendix will describe how to communicate with the CRTC. The 
CRTC has two memory addresses allocated to it. Data written to the first 
address will control which one of eighteen internal CRTC registers will 
respond to the second address. The two addresses used are: 

SC0B0 You select a CRTC register by writing the register number to 
this address. 

SC0B1 You write data to be stored in the CRTC register to this 

address. Some of the CRTC register can also be read. Others 
will return garbage data. 



Section C.1 REGISTER SUMMARY 


The default values for the 80-column videoterm emulation mode 


are 


summarized in table C.1 








TABLE C.1 






Register Register 


Access 


Power- 








on 


Number Description 


Type 


Value 


R0 


horizontal total 


write 


$82 


R1 


horizontal displayed 


write 


$50 


R2 


horizontal sync position 


write 


$64 


R3 


horizontal sync width 


write 


$29 


R4 


vertical total 


write 


$1B 


R5 


vertical adjust 


write 


$08 


R6 


vertical displayed 


write 


$18 


R7 


vertical sync position 


write 


$1A 


R8 


interlace mode 


write 


$00 


R9 


max. scan line address 


write 


$08 


R10 


cursor start 


write 


$E0 


R11 


cursor end 


write 


$08 


R12 


start address (high) 


write 


$00 


R13 


start address (low) 


write 


$00 


R14 


cursor address (high) 


read/write 


$00 


R15 


cursor address (low) 


read/write 


$00 


R16 


light pen (high) 


read 




R17 


light pen (low) 


read 





Section C.2 COMPLETE REGISTER DESCRIPTIONS 

R0 Horizontal total This is an 8 bit write-only register that 

determines the horizontal scan frequency. The count which is 
stored here is in character time units. Use the number of 
displayed characters plus the number of non-displayed 
character times, minus 1 

R1 Horizontal displayed This is an 8 bit write-only register that 
determines the size of the horizontal display area. The count 
which is stored here is the number of displayable characters 
per line. 

R2 Horizontal sync position This is an 8 bit write-only register 
that determines where in a horizontal scan the sync pulse will 
occur. The data is in character time units. 

R3 Horizontal sync width This is a 4 bit write-only register that 
determines the width of the horizontal sync pulse. The data is 
in character time units. 

R4 Vertical total register This is a 7 bit write-only register that, 
along with R5, determines the vertical refresh rate. The 
number stored here is the number of displayed lines plus the 
number of non-displayed lines that allow for 50 or 60 Hz 
refresh rates, minus 1 . The number will usually come out with 
a fractional part. Just the integer part should be used here. 

R5 Vertical adjust This is a 5 bit write-only register that 

contains the fraction needed to augment the integer value 
described for R4. 

R6 Vertical displayed This is a 7 bit write-only register that 
determines the size of the vertical display area. The count 
which is stored here is the number of character display lines. 

R7 Vertical sync position This is a 7 bit write-only register that 
determines the position of the vertical sync pulse 

R8 Interlace mode This is a 2 bit write-only register that 

specifies whether or not to interlace scan, and if so, what type 
of interlace. Bits and 1 determine the interlace mode as 
follows: 

Bit clear, bit 1 set or clear normal sync mode. I n this 
mode there is no interlace. 

Bit set, bit 1 clear interlace sync mode. Each scan line is 
output twice. This doubles the number of scan lines, without 
doubling the screen memory or font EPROM sizes. The scan 
lines themselves will only have half the normal spacing. 

Bit set, bit 1 set interlace sync with video mode. In this 
mode there will be twice as many unique scan lines output. 
The scan lines will only have half the space between them. A 
monitor with a long persistence phosphor is required. 



R9 Maximum scan line address This is a 5 bit write only 

register that determines the height of the character font. The 
value stored here should be the number of scan lines for a 
character (including any blank space above or below) 
minus 1 

R1 (9 Cursor start This is a 7 bit write-only register that 

determines cursor type, and top of cursor within a character 
cell. Bits 5 and 6 determine cursor type as follows: 

Bit 6 clear, bit 5 clear a non-blinking cursor is displayed 

Bit 6 clear, bit 5 set no cursor is displayed. 

Bit 6 set, bit 5 clear the cursor will blink at Vieth of the 

field rate. 

Bit 6 set, bit 5 set the cursor will blink at 1 /32nd of the 
field rate. 

Bits through 4 define the top of the cursor within the 
character cell. Valid numbers to specify in bits through 4 are 
©through 11 (decimal). 

R11 Cursor end This is a 5 bit write-only register that determines 
the bottom of the cursor within a character cell. The number 
stored here must be smaller than, or equal to, the value used 
for the top of cursor (bits through 4 of R1 0). 

R12 Start address (high) When combined with R13, this 6-bit 
write-only register will specify which byte of screen memory 
will be displayed in the upper left corner of the screen. These 
6 bits are the more significant bits of the start address. 

R13 Start address (low) This is an 8-bit write-only register that 
forms the low-order byte of the start address. 

R14 Cursor address (high) When combined with R1 5, this 6-bit 
read/write register will specify which byte of screen memory 
will have a cursor associated with it. These 6 bits are the more 
significant bits of the cursor address. 

R15 Cursor address (low) This is an 8 bit read/write register 
that forms the least significant byte of the cursor address. 

R16 Light pen (high) When combined with R17. this 6-bit read 
only register will provide a screen memory address. This 
address will represent a position on the screen that is 
associated with a light pen, or some other pointing device. 
The address in R16 and R17 is updated each time the light 
pen strobe goes from low to high. R1 6 represents the more 
significant part of the screen memory address. 

R1 7 Light pen (low) This is an 8-bit read only register that 
provides the low order byte of the light pen address. 





APPENDIX F 




Firmware Listing 


Section F.1 INTERFACE FIRMWARE 


El*j 






2 


********************************** 




3 


* * 




4 


* Ultraterm interface firmware * 


Mi \ ■ 


5 
6 


* V. 1.0 2 May. 1983 12:00 * 

* * 


Kj 


7 


* Written by D. A. * 


W+% 


8 


* (C) 1983 Videx, Inc. * 


9 


* * 




10 


********************************** 


[% |H 


11 


* 




12 


LINEHZ EQU 60 




13 


CO EQU SCO 




14 


C000 EQU C0*$100 




15 


* 




16 


* 




17 


* ZERO PAGE EQUATES 




18 


* 




19 


WNDWDTH EQU $21 




20 


CH EQU $24 




21 


CV EQU $25 




22 


BASL EQU $28 




23 


INVFLG EQU $32 




24 


PROMPT EQU $33 




25 


XSAVE EQU $35 




26 


CSWL EQU $36 




27 


CSWH EQU $37 




28 


KSWL EQU $38 




29 


KSWH EQU $39 




30 


AIL EQU $3C 




31 


A1H EQU $3D 




32 


A2L EQU $3E 




33 


A2H EQU $3F 




34 


A4L EQU $42 




35 


A4H EQU $43 




36 


RNDL EQU $4E 




37 


RNDH EQU $4F 




38 


* 




39 


* M1SC EQUATES 




40 


* 




41 


STACK EQU $100 




42 


IN EQU $200 




43 


VIDWAIT EQU $FB78 




44 


APVTAB EQU $FC22 




45 


SETKBD EQU $FE89 




46 


SETVID EQU $FE93 




47 


IORTS EQU $FFCB 





49 


* TEMPORARIES 




50 


A 






51 


MODE 


EQU 


$478 


52 


HEIGHT 


EQU 


$4F8 


53 


SWDTH 


EOU 


$578 


54 


PWDTH 


EQU 


$5F8 


55 


OLDCHAR 


EQU 


$678 


56 


NO 


EQU 


$6F8 


57 


TEMPX 


EQU 


$778 


58 


MSLOT 


EQU 


$7F8 


59 


* 






60 


* SLOT N 


PERMANENTS 


61 


* 






62 


BASEL 


EQU 


5478-CO 


63 


BASEH 


EQU 


S4F8-C0 


64 


CHORZ 


EQU 


$578-CO 


65 


CVERT 


EQU 


S5F8-C0 


66 


BYTE 


EQU 


$678-C0 


67 


START 


EQU 


S6F8-C0 


68 


POFF 


EQU 


S7 78-CO 


69 


* 






70 


BSTATE 


EQU 


ZOOOOOlll 


71 


BPOFF 


EQU 


sum iooo 


72 


A 






73 


FLAGS 


EQU 


S7F8-C0 


74 


* 






75 


BFORMT 


EQU 


%0000011 1 


76 


BGETLN 


EQU 


xoooioooo 


77 


BKEYBD 


EQU 


200100000 


78 


BLCCON 


EQU 


%0 1000000 


79 


BINV 


EQU 


210000000 



MOOR MASK FOR MODE CONTROL PORT 

SCREEN HEIGHT 

SCREEN WIDTH 

PRINTED SCREEN WIDTH 

PREVIOUS CHARACTER FROM GETLN 

SLOT * $10 

GENERAL TEMPORARY USAGE 

SLOT + $CO 



SCREEN BASE ADDRESS LOW 

SCREEN BASE adddress high 
CURSOR HORIZONTAL POSITION 
CURSOR VERTICAL POSITION 
I/O BYTE 

SCREEN START ADDRESS 
POWER OFF AND STATE CODE 



STATE CODE MASK 
POWER OFF MASK 



DISPLAY FORMAT MASK 
INPUT CAME FROM GETLN 
LOWERCASE KEYBOARD AVAILABLE 
U. CASE TO L. CASE CONVERT FLAG 
PASCAL INVERSE FLAG 



-F.2- 



81 

82 

83 

84 

85 

86 

87 

88 

89 

90 

91 

92 

93 

94 

95 

96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

11 1 

112 

113 

114 

115 

116 

117 

118 

119 



* APPLE [0 DEVICES 



KBD 

KBDSTRB 

SPKR 



EQU $C0 00 
EQU SCO 10 
EQU $C030 



ULTRATERM 10 PORTS 



RECSEL 

DATA 

MCREC 

MCPBITS 

MPBANK 

MPVIDEO 

MPCLOCK 

MPADDR 

* 

MB256 
MBI32 
MBSVS 
MBANK 



EQU SC080 
EQU $C081 
EQU SC082 



EQU 
EQU 
EQU 
EQU 
EQU 



ATDFLT 

ATINV1 

ATHI I 

ATCHR 

ATINVO 

ATHIO 

ATLRC 
ATSML 



CRTC REGISTER SELECTION PORT 
CRTC REGISTER DATA PORT 
MODE CONTROL REGISTER 



%1 1 1 10000 

% 10000000 
%0 1000000 
%00 100000 
200010000 



SELECTION FOR 
READ SCREEN 
APPLE VIDEO 
80 COLUMN CLOCK 
BLOCK ADDRESS MODE 



SELECTION FOR I 
ROM PACE TWO 
ULTRATERM VIDEO 
132 COLUMN CLOCK 
PACE ADDRESS MODE 



EQU MPBANK. MPVIDEO. MPADDR 

EQU MPBANK .MPVIDEO. MPCLOCK 

EQU MPBANK. MPVIDEO 

EOU MPBANK 



ATTREG EQU SC083 



EQU 

EQU 
EQU 
EQU 
EQU 
EQU 

EQU 
EQU 



X 10000000 
%00I 00000 
200010000 
200000100 
%00000010 
%00000001 

ATDFLT 
ATDFLT. ATCHR 



CHARACTER ATTRIBUTE REGISTER 

SELECT DEFAULT HILtTE, INVERSE 
SELECT INVERSE FOR D7 = 1 
SELECT HLLICHT FOR D7 = 1 
SELECT LOW DENSITY CHARACTER SET 
SELECT INVERSE FOR D7 = 
SELECT HILtCHT FOR D7 = 



* ULTRATERM SCREEN MEMORY 



DISPO 
DISP1 



EQU 
EQU 



SCCOO 
SCDOO 



PRIMARY SCREEN PACE 

SECONDARY SCREEN PACE FOR BLOCK MODE 



-F.3- 



OBJ 


S8000 


ORG 


COOO 


DS 


C000+$100-* 


>>> 


CNOO 


DO 


COOO+S300-* 


«< 




>>> 


CNOO 


DO 


C000+$300-* 


<« 




>» 


CNOO 


DO 


C 000+ $300-* 


LST 


OFF 


FIN 





121 

122 

123 * 

437 * 

438 

439 * 

440 

440 

440 

441 

441 

441 

442 

& U 2 

442 

442 

442 * 

442 * BASIC INITIAL t/0 ENTRY POINT 

442 * 

442 ENTER 
C300: 2C CB FF 442 BIT IORTS ; SET VFLAC IN INITIAL ENTRY 

C303: 70 39 442 BVS ENTR 

442 INFAKE 
C305: 38 442 SEC ; FAKE INPUT ENTRY C=l 

C306: 90 442 HEX 90 

442 OUTENTR 
C307: 18 442 CLC 

C308: B8 442 CLV 

C309: 50 33 442 BVC ENTR 

442 * 

442 * 
C30B: 01 87 442 HEX 0187 ; ULTRATERM IDENTITY WORD 

442 * 

442 * PASCAL I/O ADDRESSES AND ROUTINES 

442 * 

C30D: 17 442 

C30E: ID 442 

C30F: 24 442 

C310: 2A 442 

442 * 
C311: 4C 63 C3 442 
C314: 4C BO C3 442 

442 * 

442 INIT 
C317: 20 00 C8 442 
C31A: A2 00 442 

C31C: 60 442 

442 * 

442 READ 
C31D: 20 42 CB 442 
C320; 29 7F 442 

C322: 10 13 442 

442 * 

442 WRIT 
C324: 20 04 CB 442 
C32 7: A2 00 442 
C329: 60 442 



DFB 


INIT 


DFB 


READ 


DFB 


WRITE 


DFB 


STATUS 


JMP 


MOVE 


JMP 


XFER 


JSR 


PINIT 


LDX 


0$OO 


RTS 




JSR 


PREAD 


AND 


0S7F 


BPL 


CLRX 


JSR 


PWRITE 


LDX 


//SOO 


RTS 













442 


■k 














442 


STATUS 






C32A: 


C9 


00 




442 




CMP 


noo 


C32C: 


FO 


09 




442 




BEO 


CLRX 


C32F.: 


AD 


00 


CO 


442 




LDA 


KBD 


C331: 


OA 






442 




ASL 




C332: 


90 


03 




442 




BCC 


CLRX 


C334: 


20 


9C 


CA 


442 

442 


CLRX 


JSR 


KEYSTAT 


C337: 


A 2 


00 




442 




LDX 


t'SOO 


C339: 


60 






442 
442 


* 


RTS 












442 


* BASIC 


INPUT 


ENTRY POINT 










442 


* 














442 


INENTR 






C33A: 


91 


28 




442 




STA 


(8ASL),Y 


C33C: 


38 






442 




SEC 




C33D: 


B8 






442 
442 


ENTR 


CLV 




C33C: 


SD 


F8 


05 


442 




STA 


PWDTH 


C341: 


86 


35 




442 




STX 


XSAVE 


C343: 


48 






442 




PHA 




C344: 


8A 






442 




TXA 




C345: 


48 






442 




PHA 




C346: 


98 






442 




TYA 




C347: 


48 






442 




PHA 




C348: 


AD 


F8 


05 


442 




LDA 


PWDTH 


C34B: 


48 






442 




PHA 




C34C: 


AD 


FF 


CF 


442 




LDA 


SCFFF 


C34F: 


A 2 


C3 




442 




LDX 


OENTER 


C351: 


AO 


30 




442 




LDY 


//>ENTER*$10 


C353: 


50 


03 




442 




BVC 


10 


C355: 


4C 


FB 


C3 


442 
442 
442 


LO 


JMP 


8INIT 


C358: 


BO 


03 




442 




BCS 


INPUT 


C35A: 


4C 


FA 


C3 


442 
442 
442 


INPUT 


JMP 


OUTPUT 


C35D: 


20 


1A 


C8 


442 




JSR 


BSTART 


C360: 


4C 


AD 


C9 


442 




JMP 


BASINP 



REPLACE FLASHING CURSOR 



SAVE CHARACTER 

SAVE INPUT BUFFER INDEX 

SAVE RECISTERS ON STACK 



RETRIEVE CHARACTER 

PUSH IT ON STACK 

TURN OFF CO-RESIDENT MEMORY 

ESTABLISH INDEX VALUES 

DO I/O IF NOT INITIAL ENTRY 



DO INPUT IF CARRY SET 



SETUP TEMPORARIES 
DO INPUT 











442 


* APPLE 


lie MOVE ROUTIt 










442 


* 














442 


MOVE 






C363 


48 






442 




PHA 




C364 


98 






442 




TYA 




C365 


48 






442 




PHA 




C366 


AD 


13 


CO 


442 




LDA 


SCO 13 


C369 


48 






442 




PHA 




C36A 


AD 


14 


CO 


442 




LDA 


SC014 


C36D 


48 






442 
442 


* 


PHA 




C36E 


90 


08 




442 




BCC 


M0VF.C2M 


C370 


8D 


02 


CO 


442 




STA 


SC002 


C373 


8D 


05 


CO 


442 




STA 


SC005 


C376 


BO 


06 




442 
442 
442 


* 
M0VEC2M 


BCS 


MOVESTRT 


C378 


80 


04 


CO 


442 




STA 


$C004 


C37B 


8D 


03 


CO 


442 
442 

442 


MOVESTRT 


STA 


$C003 


C37E 


AO 


00 




442 
442 
442 


MOVELOOP 


LDY 


ffSOO 


C380 


Bl 


3C 




442 




LDA 


(A1L),Y 


C382 


91 


42 




442 




STA 


(A4L),Y 


C384 


E6 


42 




442 




INC 


A4L 


C386 


DO 


02 




442 




BWE 


NXTAl 


C388 


E6 


43 




442 

442 


NXTAl 


INC 


A4H 


C38A 


A5 


3C 




442 




LDA 


AIL 


C38C 


C5 


3E 




442 




CMP 


A2L 


C38E 


A5 


3D 




442 




LDA 


AlH 


C390 


E5 


3F 




442 




SBC 


A2H 


C392 


E6 


3C 




442 




INC 


AIL 


C394 


DO 


02 




442 




BNE 


C01 


C396 


E6 


3D 




442 
442 


C01 


INC 


AlH 


C398 


90 


£6 




442 
442 


* 


BCC 


MOVELOOP 


C39A 


8D 


04 


CO 


442 




STA 


$C004 


C39D 


68 






442 




PLA 




C39E 


10 


03 




442 




BPL 


C03 


C3A0 


8D 


05 


CO 


442 
442 


C03 


STA 


SC005 


C3A3 


8D 


02 


CO 


442 




STA 


SC002 


C3A6 


68 






442 




PLA 




C3A7 


10 


03 




442 




BPL 


MOVERET 


C3A9 


8D 


03 


CO 


442 
442 


MOVERET 


STA 


$C003 


C3AC 


68 






442 




PLA 




C3AD 


A8 






442 




TAY 




C3AE 


68 






442 




PLA 




C3AF 


60 






442 




RTS 













442 


* APPLE 


//e XFER ROUT 










442 


* 














442 


XFER 






C3B0 


48 






442 




PKA 




C3B1 


AD 


ED 


03 


442 




LDA 


S03ED 


C3B4 


48 






442 




PHA 




C3B5 


AD 


EE 


03 


442 




LDA 


$03EE 


C3B8 


48 






442 
442 


* 


PHA 




C3B9 


90 


OA 




442 




BCC 


XFERC2M 


C3BB 


80 


03 


CO 


442 




STA 


$C003 


C3BE 


80 


05 


CO 


442 




STA 


$C005 


C3C1 


50 


19 




442 




BVC 


XFERSZP 


C3C3 


70 


08 




442 
442 


XFERC2M 


BVS 


XFERAZP 


C3C5 


8D 


02 


CO 


442 




STA 


$C002 


C3C8 


80 


04 


CO 


442 




STA 


$C004 


C3CB 


50 


OF 




442 
442 
442 


XFERAZP 


BVC 


XFERSZP 


C3CD 


68 






442 




PLA 




C3CE 


8D 


EE 


03 


442 




STA 


$03EE 


C3D1 


68 






442 




PLA 




C3D2 


8D 


ED 


03 


442 




STA 


$03ED 


C3D5 


68 






442 




PLA 




C3D6 


5D 


09 


CO 


442 




STA 


$C009 


C3D9 


6C 


ED 


03 


442 
442 
442 


XFERSZP 


JMP 


($03ED) 


C3DC 


68 






442 




PLA 




C3DD 


8D 


EE 


03 


442 




STA 


$03EE 


C3E0 


68 






442 




PLA 




C3E1 


8D 


ED 


03 


442 




STA 


$03ED 


C3E4 


68 






442 




PLA 




C3E5 


80 


08 


CO 


442 




STA 


$C008 


C3E8 


6C 


ED 


03 


442 




JMP 


(S03ED) 
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44 2 


* 


BASIC 


INITIALIZE 












442 


* 


















442 


8INIT 








C3EB: 


A9 


3A 




442 






LDA 


fflNENTR ; 


LNIT INPUT ENTRY POINT 


C3ED: 


85 


38 




442 






STA 


KSWL 




C3EF: 


86 


39 




442 






STX 


KSWH 




C3F1: 


A9 


07 




442 






LDA 


//OUTENTR ; 


INIT OUTPUT ENTRY POINT 


C3F3: 


85 


36 




442 






STA 


CSWL 




C3F5: 


86 


37 




442 






STX 


CSWH 




C3F7: 


20 


00 


C8 


442 
442 
442 


* 




JSR 


P1NLT ; 


LNIT PERMANENTS AND CRTC 










442 


OUTPUT 








C3FA: 


20 


IA 


C8 


442 






JSR 


BSTART j 


.SETUP TEMPORARIES 


C3FD: 


K 


15 


CA 


442 
442 
443 
443 
443 
444 
444 
444 
445 
445 
445 
446 
446 
446 






JMP 
«< 
>» 
DO 

<« 

»> 

DO 

«< 

»> 

DO 

<« 

>» 

DO 

<<< 


BASOUT ; 

CNOO 
C000+S300-* 

CNOO 
C000+S300-* 

CNOO 
C000+S300-* 

CNOO 
C000+$300-* 


OUTPUT CHARACTER 



C800: 38 
C801: 90 



C802 
C803 
C806 



2C 58 CB 

20 1C C8 



C809: AD 78 04 
C80C: 29 7F 

AC F8 06 
99 82 CO 
80 78 04 



C80E: 
C8U: 
C8I4: 



C817: 60 



C818: 38 
C8I9; 90 



C81A: 18 
C81B: B8 



C81C: 8C K8 06 

C81F: 8K F8 07 

C822: 70 03 

C824: 4C CF C8 



C827: B« 08 

C829: A9 30 

C82B: 90 118 06 

C82E: 4C 6F C8 



C831 : BD B8 06 

C834: 29 1-8 

C836: 49 30 

C838: C9 01 

C83A: B8 

C83B: 70 

C83C: 38 

C83D: A9 30 

C83F: 90 B8 06 

C842: 90 03 



448 
449 
450 
451 
452 
453 
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 
469 
470 
471 
472 
473 
474 
475 
476 
477 
4 78 
479 
4 80 
481 
482 
483 
484 
485 
486 
487 
488 
489 
490 
49! 
492 
493 
494 
495 
496 
497 
498 



CO-RES I DENT ROM CODE 



SEC 




HEX 


90 


CLC 




BIT 


RTSO 


JSR 


IENTER1 


LDA 


MODE 


AND 


AM BANK! SFF 


LDY 


NO 


STA 


MCREC.Y 


STA 


MODE 



SEC 
HEX 



CLC 
CLV 



STY 

STX 
BVS 
JMP 



BCS 
LDA 
STA 

JMP 



LDA 
AND 

EOR 
CMP 
CLV 
HEX 

SBC 
LDA 
STA 

BCC 



NO 

MSLOT 
SETUP 
CSTART 



SETUP1 

*S30 

I'OFF.X 

N^WFMT 



POFF,X 
flBPOFF 
//S30 

rf/SOl 

70 



//S30 
POFF.X 

TFXIT 



ESTABLISH NO 

ESTABLLSH MSLOT 

OVERFLOW SET UPON INITIALIZE 

CO TO COMMON START ROUTINE 



CARRY CLEAR IF FORMAT IN IT 
SET POWER OFF BYTE 



SET FORMAT 



GET POWER OFF FLAG 
STRIP OFF STATE CODE 

HAS POWER BEEN TURNED OFF? 



CLEAR POWER OFF BYTE 

CARRY SET IF IN IT IS NEEDED 
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500 










501 


C844: 


AO 


20 




502 


C846: 


A9 


A5 




503 


C848: 


48 






504 


C849: 


4C 


50 


C8 


505 
506 
507 


C84D: 


4C 


42 


CD 


508 
509 
510 


C850: 


8D 


09 


CO 


511 


C853: 


68 






512 


C854: 


8D 


08 


CO 


513 


C857: 


C9 


A5 




514 


C859: 


DO 


10 




515 


C85B: 


A9 


5A 




516 


C85D: 


48 






517 


C85E: 


8D 


09 


CO 


518 


C861: 


68 






519 


C862: 


8D 


08 


CO 


520 


C865: 


C9 


5A 




521 


C867: 


UO 


02 




522 


C869: 


AO 


00 




523 
524 
525 


C86B: 


98 






526 


C86C: 


9D 


38 


07 


527 
528 


C86F: 


20 


DA 


C8 


529 


C872: 


A9 


00 




530 


C874: 


9D 


B8 


03 


53 1 


C877: 


9D 


38 


04 


532 


C87A: 


90 


B8 


04 


533 


C87D: 


9D 


38 


05 


534 


C880: 


9D 


38 


06 


535 



CHECK FOR APPLE lie 



LDY 


'/BKEYBD 


LDA 


*$A5 ; 


PHA 




JMP 


RDSKIP 


DS 


C000+S84D-* 


JMP 


PREAD 


STA 


$C009 ; 


PLA 




STA 


SC008 ; 


CMP 


*$A5 ; 


BNE 


A2E ; 


LDA 


tf$5A ; 


PHA 




STA 


$C009 ; 


PLA 




STA 


$C008 ; 


CMP 


0$5A ; 


BtfE 


A2E ; 


LDY 


*$00 ; 


TYA 




STA 


FLACS,X 


JSR 


NEWFMT2 


LDA 


#$00 ; 


STA 


BASEL, X 


STA 


BASEH,X 


STA 


CH0RZ,X 


STA 


CVERT,X 


STA 


START, X 



PICK AN UNLIKELY VALUE 
PUSH IT ON THE STACK 



SWITCH TO STACK 2 (APPLE //e) 

RETRIEVE VALUE 

RETURN TO STACK 1 (APPLE lie) 

IF DIFFERENT THEN IT 

IS AN APPLE lie,. 

PICK ANOTHER UNLIKELY VALUE 

PUSH IT ON THE STACK 

SWITCH TO STACK 2 (APPLE He) 

RETRIEVE VALUE 

RETURN TO STACK 1 (APPLE lie) 

IF THE SAME THEN ASSUME AN 

APPLE ] [ OR APPLE ] [ + 

DON'T SET LOWERCASE KEYBOARD 



SAVE KEYBOARD MODE 



CLEAR PERMANENTS 











537 


* CLEAR SCREEN MEMORY 










538 


* 




C883 


A2 


OF 




539 


LDX 


(ISO? 


C885 


AO 


00 




540 
54 1 


LDY 
CL00P1 


DSOO 


C887 


98 






542 


TYA 




C888 


48 






543 


PKA 




C889 


8A 






544 


TXA 




C88A 


OD 


78 


•4 


545 


ORA 


MODE 


C88D 


09 


DO 




546 


ORA 


MB2 56 


C88F 


AC 


F8 


06 


547 


LDY 


NO 


C892 


99 


82 


CO 


548 


STA 


MCREC.Y 


C895 


68 






549 


PLA 




C896 


A8 






550 


TAY 




C897 


A9 


20 




551 
552 


LDA 
C SLOOP 1 


it $20 


C899 


99 


00 


CC 


553 


STA 


$CC0O,Y 


C89C 


C8 






554 


INY 




C89D 


DO 


FA 




555 


BNE 


CSL00P1 


C89F 


CA 






556 


DEX 




C8A0 


11 


E5 




557 


BPL 


CL00P1 


C8A2 


AJi 


F8 


07 


558 


LDX 


MSLOT 


C8A5 


AC 


F8 


06 


559 


LDY 


NO 


C8A8 


AD 


78 


04 


560 


LDA 


MODE 


C8AB 


99 


82 


CO 


561 


STA 


MCREC,Y 


C8AE 


BD 


38 


07 


562 


LDA 


FLAGS, X 


C8B1 


29 


07 




563 


AND 


i'/BFORMT 


C8B3 


OA 






564 


ASL 




C8B4 


OA 






565 


ASL 




C8B5 


OA 






566 


ASL 




C8B6 


OA 






567 


ASL 




C8B7 


AA 






568 


TAX 




C8B8 


29 


OF 




569 
570 


ANO 
LOOP 


tf$OF 


C8BA 


99 


80 


CO 


571 


STA 


RECSEL.Y 


C8BD 


BD 


8A 


CE 


572 


LDA 


TABLE, X 


C8C0 


99 


81 


CO 


573 


STA 


DATA,Y 


C8C3 


E8 






574 


I NX 




C8C4 


8A 






575 


TXA 




C8C5 


29 


OF 




576 


AND 


0SOF 


C8C7 


DO 


Fl 




577 


BNE 


LOOP 


C8C9 


AE 


F8 


07 


578 


LDX 


MSLOT 


C8CC 


4C 


AC 


CB 


579 


JMP 


HOME 



CLEAR $10 PAGES 



PUT PAGE NUMBER IN A 
OR IN MODE MASK 
USE PAGE ADORESSLNC 

SELECT PACE 



USE NORMAL SPACE 
CLEAR ENTIRE PAGE 



NEXT PAGE 

RESTORE X 

GET DEVICE INDEX 

RESTORE ADDRESS MODE 

; COMPUTE FORMAT TABLE INDEX 



USE LOWER FOUR BITS 

FOR THE CRTC ADDRESS 
GET THE PARAMETER 
STORE INTO THE CRTC 



LOOP UNTIL DONE 
RESTORE X REGISTER 
HOME CURSOR 



C8CF: 90 41 

C801: BD 38 07 

C8D4: 49 80 

C8D6: 85 32 

C8D8: 38 

C8D9: 90 



C8DA: 
C8DB: 
C8DE: 
C8E1 : 
C8E3: 
C8E4: 
C8E7: 
C8EA: 
C8ED: 
C8F0: 
C8F3: 
C8F6: 
C8F9: 
C8FC: 
C8FF: 
C901: 
C903: 
C905: 
C908: 
C90B: 



AC F8 06 
BD 38 07 
29 07 
AA 

BD 24 C9 
8D 78 04 
99 82 CO 
BD 2C C9 
8D F8 04 
BD 34 C 9 
8D 78 05 
BD 3C C9 
8D F8 05 
A9 29 
85 21 
BO 09 
BD 44 C9 
99 83 CO 
AD 78 04 



C90E: AE F8 07 

C911: 60 

C912: A9 AO 

C914: CD F8 04 

C917: DO BF 

C919: CD 78 05 

C91C: DO BA 

C91E: 20 D8 C8 

C92I : 4C AA CB 



581 
582 
583 
584 
585 
586 
587 
588 
589 
590 
591 
592 
593 
594 
595 
596 
597 
598 
599 
600 
601 
602 
603 
604 
605 
606 
607 
608 
609 
610 
611 
612 
613 
614 
615 
616 
617 
618 
619 
620 



BCC BSTART1 

LDA FLAGS, X 

EOR /!>$80 

STA INVFLC 

SEC 

HEX 90 



DO BASIC HOME TEST 

SET INVERSE FLAG FOR PASCAL 



CLC 
LDY 
LDA 
AND 
TAX 
LDA 
STA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
BCS 
LDA 
STA 
LDA 



LDA 
CMP 
BNE 
CMP 
BNE 
JSR 



NO 

FLACS.X 

0BFORMT 

MODTBL.X 

MODE 

MCREC.Y 

HGTBL.X 

HEIGHT 

SWDTBL,X 

SWDTH 

PWDTBL ? X 

PWDTH 

Ml 

WNDUDTH 

NFSKIP 

ATRT6L,X 

ATTREC.Y 

MODE 



LDX MSLOT 
RTS 



tfSAO 

HEIGHT 

TINIT 

SWDTH 

TINIT 

TINIT 



GET FORMAT NUMBER FOR INDEX 

SET MODE MASK 

ASSURE PROPER MODE 
SET HEIGHT 

SET SCREEN WIDTH 

SET PRINTED WIDTH 

ADJUST WINDOW FOR HOME DETECT 

EXIT IF START SETUP 
INITIALIZE ATTRIBUTES 



IF TWO TEMPORARIES ARE SPACES 
THEN HOME HAS OCCURED 



JMP CLSCRN 



CLEAR THE SCREEN 







622 


MODTBL 






C924 


CO 


623 




DFB 


MBSVS 


C925 


DO 


624 




DF8 


MB256 


C926 


FO 


625 




DFB 


M8256.MB132 


C92 7 


DO 


626 




DFB 


MB256 


C928 


DO 


62 7 




DF8 


M8256 


C929 


DO 


628 




DFB 


MB256 


C92A 


FO 


629 




DFB 


M8256.MB132 


C92B 


FO 


630 

631 
632 


* 

HCTBL 


DFB 


MB256.MB132 


C92C 


18 


633 




DFB 


24 


C92D 


18 


634 




DFB 


24 


C92E 


18 


635 




DF8 


24 


C92F 


18 


636 




DFD 


24 


C930 


20 


637 




DFB 


32 


C931 


30 


638 




DFB 


48 


C932 


18 


639 




DFB 


24 


C933 


20 


640 
641 
642 


* 
SWDTBL 


DFB 


32 


C934 


50 


643 




DFB 


80 


C935 


60 


644 




DFB 


96 


C936 


AO 


645 




DFB 


160 


C937 


50 


646 




DFB 


80 


C938 


50 


647 




DFB 


80 


C939 


50 


648 




DF8 


80 


C93A 


AO 


649 




DFB 


160 


C93B 


80 


650 

651 
652 


* 

PWDTBL 


DFB 


128 


C93C 


50 


653 




DFB 


80 


C93D 


60 


654 




DFB 


96 


C93E 


AO 


655 




DFD 


160 


C93F 


50 


656 




DFB 


80 


C940 


50 


657 




OFB 


80 


C941 


50 


658 




DF8 


80 


C9A2 


84 


659 




DFB 


132 


C943 


80 


660 
661 
662 


* 
ATRTBL 


DFB 


128 


C944 


84 


663 




DFB 


ATSML 


C945 


84 


664 




DFB 


ATSML 


C946 


84 


665 




DFB 


ATSML 


C947 


80 


666 




DFB 


ATLRC 


C948 


80 


667 




DFB 


ATLRC 


C949 


84 


668 




DFB 


ATSML 


C94A 


80 


669 




DF8 


ATLRG 


C948 


80 


670 




DFB 


ATLRG 



— F.13— 











672 


C94C: 


AD 


78 


04 


673 


C94F: 


29 


7F 




674 


C951: 


8D 


78 


04 


675 


C954: 


BC 


B8 


04 


676 


C957: 


20 


78 C9 


677 


C95A: 


BO 


00 


CC 


678 


C95D: 


90 


03 




679 


C95F: 


BD 


00 


CD 


680 
681 


C962: 


AA 






682 


C963: 


AD 


78 


04 


683 


C966: 


09 


80 




684 


C968: 


80 


78 


04 


685 


C96B: 


AC 


F8 


06 


686 


C96E: 


99 


82 


CO 


687 


C971 : 


8A 






688 


C972: 


AE 


F8 


07 


689 


C975: 


09 


80 




690 


C977: 


60 






691 
692 
693 


C978: 


18 






694 


C979: 


98 






695 


C97A: 


48 






696 


C97B: 


7D 


68 


03 


697 


C97E: 


48 






698 


C97F: 


A9 


00 




699 


C981: 


7D 


38 


04 


700 


C984: 


29 


or 




701 


C986: 


OD 


78 


04 


702 


C989: 


AC 


F8 


06 


703 


C98C: 


99 


82 


CO 


704 


C98F: 


48 






705 


C990: 


OA 






706 


C991 : 


29 


OC 




707 


C993: 


OD 


F8 


06 


708 


C996: 


AA 






709 


C997: 


BD 


80 


CO 


710 


C99A: 


68 






711 


C99B: 


4A 






712 


C99C: 


68 






713 


C99D: 


AA 






7)4 


C99E: 


68 






715 


C99F: 


A8 






716 


C9A0: 


60 






7)7 
718 
719 
720 


C9AA: 


AC 


07 


CB 


72 1 



LDA MODE ; SET MODE TO SELECT READ SCREEN 

AND f?S7F 

STA MODE 

LDY CHORZ.X ; COMPUTE SCREEN Af DRESS 

JSR PACSEL 

LDA DISPO,X ; READ SCREEN 

BCC RSKIP1 

LDA DISP1.X 

TAX 

LDA MODE ; FIX MODE 

ORA i'MBANK 

STA M«DE 

LDY NO ; FIX MODE CONTROL PORT 

STA MCREC,Y 

TXA 

LDX MSLOT ; RESTORE X RKCISTER 

ORA #580 



RTS 



PACSEL 

CLC 



TYA ; ADD CHORZ TO BASE ADDRESS 

PHA 

ADC BASEL, X 

PHA ; SAVE SCREEN ADDRESS LOW 

LDA 0SOO 

ADC BASEH,X 

AND //MCPBITS!SFF ; SELECT SCREEN PACE 

ORA MODE ; FOR PACE ADDRESS INC MODE 

LDY NO 

STA MCREC.Y 

PHA 

ASL 

AND 0SOC J SELECT SCREEN BLOCK 

OKA NO ; FOR BLOCK ADDRESSING MODE 

TAX 

LDA RECSEL,X 

PLA 

LSR ; PUT BIT 8 OF ADDRESS IN CARRY 

PLA 

TAX ; PUT ADDRESS LOW IN X 

PLA 

TAY ; RESTORE Y 

RTS 



DS C0O0+S9AA- 
JMP PWRITE1 











723 BASINP 






C9AD 


68 






724 


PLA 




C9AE 


20 


17 


CE 


725 


JSR 


FIXCSR 


C9B1 


A4 


35 




726 


LDY 


XSAVE 


C9B3 


FO 


2B 




727 


BEQ 


GETLN 


C9B5 


88 






728 


DEY 




C9B6 


AD 


78 


06 


729 


LDA 


OLDCHAR 


C9B9 


C9 


88 




730 


CMP 


tfS88 


C9BB 


FO 


23 




731 


BEQ 


GETLN 


C9BD 


D9 


00 


02 


732 


CMP 


IN,Y 


C9C0 


FO 


IE 




733 


BEQ 


GETLN 


C9C2 


20 


79 


CB 


734 


JSR 


CAPSLK 


C9C5 


D9 


00 


02 


735 


CMP 


IN,Y 


C9C8 


DO 


35 




736 


BNE 


NTGETLN 


C9CA 


AD 


78 


06 


737 


LDA 


OLDCHAR 


C9CD 


99 


00 


02 


738 


STA 


IN,Y 


C9D0 


BO 


OE 




739 

740 ESC 


BGE 


GETLN 


C9D2 


20 


B9 


CD 


741 


JSR 


ESCNEW 


C9D5 


A9 


CO 




742 


LDA 


0MBSVS 


C9D7 


2D 


78 


04 


743 


AND 


MODE 


C9DA 


DO 


04 




744 


ONE 


CETLN 


C9DC 


A9 


98 




745 


LDA 


0S98 


C9DE 


UO 


1C 




746 

747 CETLN 


BNE 


NOTPICK 


C9E0 


A9 


10 




748 


LDA 


//BGETLN 


C9E2 


20 


98 


CB 


749 


JSR 


FLGSET 


C9E5 


20 


59 


CB 


750 


JSR 


RDKEY 


C9E8 


C9 


9B 




751 


CMP 


//$9B 


C9EA 


FO 


E6 




752 


BEO 


ESC 


C9EC 


C9 


8D 




753 


CMP 


//$8D 


C9EE 


DO 


05 




754 


BNE 


NOTCR 


C9F0 


48 






755 


PHA 




C9F1 


20 


80 CC 


756 


JSR 


FIXBUF 


C9F4 


68 






757 

758 NOTCR 


PLA 




C9F5 


C9 


95 




759 


CMP 


0S95 


C9F7 


DO 


03 




760 


BNE 


NOTPICK 


C9F9 


20 


AC 


C9 


761 

762 NOTPICK 


JSR 


RDSCRN 


C9FC 


A8 






763 


TAY 




C9F0 


DO 


05 




764 

765 NTCETLN 


BNE 


SAVOLD 


C9FF 


20 


59 


CB 


766 


JSR 


RDKEY 


CA02 


AO 


00 




767 

768 SAVOLD 


LDY 


0$OO 


CA04 


8C 


78 


06 


769 


STY 


OLDCHAR 


CA07 


BA 






770 


TSX 




CA08 


E8 






771 


INX 




CA09 


E8 






772 


INX 




CAOA 


F,8 






773 


rwx 




CAOB 


9D 


00 


01 


774 


STA 


$100, X 


CAOE 


AE 


F8 


07 


775 


LDX 


MSLOT 


CA11 


AO 


00 




776 


LDY 


#soo 


CA13 


FO 


58 




777 


BEQ 


SETCH 



POP STACK 

ADJUST CURSOR FOR GET STATEMENTS 

GET INPUT BUFFER INDEX 

IF ZERO ASSUME GETLN 

CET LAST CHARACTER FROM CETLN 
IF BS ASSUME GETLN 

IF SAME AS GHARACTER IN INPUT 
BUFFER THEN ASSUME GETLN 
CHECK AS UPPERCASE ALSO 



GET LAST CHARACTER FROM GETLN 
FIX INPUT BUFFER 
GO TO CETLN 

PERFORM ESCAPE FUNCTtON 
WAS IT AN EXIT COMMAND? 

NO, CONTINUE READING CHARACTERS 

YES, RETURN A CONTROL X 



SET GETLN FLAC 



CET CHARACTER FROM KEYBOARD 
CHECK FOR ESCAPE 



CHECK FOR CR 



FIX INPUT BUFFER FOR MIXED 
UPPERCASE AND LOWERCASE 



CHECK FOR PICK 

READ THE SCREEN 

SAVE CHARACTER IN OLDCHAR 



CET CHARACTER FROM KEYBOARD 
CLEAR OLDCHAR 



PUT CHARACTER [NTO STACK 



RECOVER X 
SET CH - 











779 BASOUT 






CA15: 


8D 


38 


07 


780 


LDA 


FLACS.X 


CA18: 


29 


10 




781 


AND 


II BGETLN 


CA1A: 


C9 


10 




782 


CMP 


0BCETLN 


CA1C: 


68 






783 


PLA 




CA1D: 


90 


08 




784 


BLT 


BOUT 


CA1F: 


AC 


78 


06 


785 


LDY 


OLDCHAR 


CA22: 


CO 


EO 




786 


CPY 


//$E0 


CA24: 


90 


01 




787 


BLT 


BOUT 


CA26: 


98 






788 

789 BOUT 


TYA 




CA27: 


9D 


B8 


05 


790 


STA 


BYTE.X 


CA 2A : 


20 


17 


CE 


791 


JSR 


FtXCSR 


CA20: 


20 


06 


CE 


792 


JSR 


0UTPT1 


CA 30 : 


E4 


39 




793 


CPX 


KSWH 


CA32: 


FO 


06 




794 


BEQ 


NOCSR 


CA34: 


20 


10 


CB 


795 


JSR 


CSRMOV 


CA37: 


20 


50 


CE 


796 

797 NOCSR 


JSR 


FIXWDTH 


CA3A: 


A9 


EF 




798 


LDA 


//8CETLN 


CA3C: 


20 


A3 


C8 


799 


JSR 


FLCCLR 


CA3F: 


BD 


B8 


05 


800 


LDA 


BYTE,X 


CA42: 


C9 


5D 




80 1 


CMP 


tf$8D 


CA44: 


DO 


18 




802 


BNE 


LSTFIX 


CA46: 


AC 


00 


CO 


803 


LDY 


KBD 


CA49: 


10 


13 




804 


BPL 


LSTFIX 


CA4B: 


CO 


93 




805 


CPY 


0593 


CA4D: 


00 


OF 




806 


BNE 


LSTFIX 


CA4F: 


2C 


10 


CO 


807 

808 KBDWAIT 


BIT 


KBDSTRB 


CA52: 


AC 


00 


CO 


809 


LDY 


KBD 


CA55: 


10 


FB 




810 


BPL 


KBDWAIT 


CA57: 


CO 


83 




811 


CPY 


//S83 


CA59: 


FO 


03 




812 


BEQ 


LSTFIX 


CA5B: 


2C 


10 


CO 


813 

814 LSTFIX 


BIT 


KBDSTRB 


CA5E: 


AO 


00 




815 


LDY 


#$00 


CA60: 


BD 


B8 


04 


816 


LDA 


CHORZ,X 


CA63: 


ED 


F8 


05 


817 


SBC 


PWDTH 


CA66: 


C9 


F8 




818 


CMP 


tf$F8 


CA68: 


90 


03 




819 


BCC 


SETCH 


CA6A: 


69 


27 




820 


ADC 


#$2 7 


CA6C: 


A8 






821 

822 SETCH 


TAY 




CA6D: 


84 


24 




823 


STY 


CH 


CA6F: 


A9 


CO 




824 


LDA 


0M8SVS 


CA71: 


2D 


78 


04 


825 


AND 


MODE 


CA74: 


DO 


15 




826 


BNE 


NORMOUT 


CA76: 


A9 


17 




827 


LDA 


023 


CA78: 


C5 


25 




828 


CMP 


cv 


CA7A: 


BO 


03 




829 


BCE 


VSKIP 


CA7C: 


9D 


38 


05 


830 

831 VSKIP 


STA 


CVERT,X 


CA7F: 


20 


93 


FE 


832 


JSR 


SETVID 


CA82: 


20 


89 


FE 


833 


JSR 


SETKBD 


CA85: 


20 


22 


FC 


834 


JSR 


APVTA8 


CA88: 


20 


50 


CE 


835 


JSR 


FIXWDTH 



CHECK CETLN FLAC 



IF CLEAR THEN SKIP 

CET LAST INPUT CHARACTER 

IF IT IS LOWERCASE THEN USE IT 



SAVE CHARACTER IN BYTE 

ADJUST CURSOR POSITION 

OUTPUT CHARACTER 

IF INPUT HOOK ISN'T CONNECTED 

THEN PUT A CURSOR ON THE SCREEN 



//8CETLN!$FF j CLEAR THE CETLN FLAC 



WAS IT A CR? 

NO, DO NOT STOP LISTING 

HAS CONTROL S BEEN STRUCK? 



NO, DO NOT STOP LISTINC 
CLEAR KEYBOARD STROBE 



WAIT UNTIL NEXT KEY TO RESUME 
IS IT CONTROL C? 
IF SO, THEN RETURN WITH IT 
IF NOT, CLEAR KEYBOARD STROBE 

START WITH ZERO 

GET CURSOR HORIZONTAL 

WITHIN 8 CHARACTERS OF RIGHT? 

NO, PUT ZERO IN CH 

YES, ADJUST CH FOR LISTINCS 



SAVE NEW CH 

SWITCH TO 40 COLUMNS? 
NO, SKIP TO EXIT 
FIX CURSOR VERTICAL 



PR 00 
IN//0 
VTAB 

FIX WINDOW WIDTH 











837 


NORMOUT 








CA8B: 


20 


09 


C8 


838 




JSR 


EXIT 


; SWITCH TO 40 COLUMNS 


CA8E: 


A£ 


F8 


07 


839 




LDX 


MSLOT 


; RECOVER X 


CA91: 


BD 


38 


05 


840 




LOA 


CVERT,X 


; SET CV * CVERT 


CA94: 


85 


25 




841 




STA 


CV 




CA96: 


68 






842 




PLA 




; RECOVER REGISTERS 


CA97: 


A8 






843 




TAY 






CA98: 


68 






844 




PLA 






CA99: 


AA 






845 




TAX 






CA9A: 


68 






846 




PLA 






CA98: 


60 






84 7 




RTS 















849 


KEYSTAT 






CA9C: 


48 






850 




PHA 




CA9D: 


C9 


eo 




851 




CMP 


0$EO 


CA9F: 


90 


08 




852 




BLT 


NOTLWR 


CAA) : 


A9 


20 




853 




LDA 


//BKEYBD 


CAA3: 


ID 


38 


07 


854 




ORA 


FLAGS, X 


CAA 6: 


9D 


38 


07 


855 
856 


NOTLWK 


STA 


FLAGS, X 


CAA9: 


BD 


38 


07 


857 




LDA 


FLAGS, X 


CAAC: 


29 


20 




858 




AND 


//BKEYBD 


CAAE: 


C9 


20 




859 




CMP 


//BKEYBD 


CABO: 


68 






860 




PLA 




CAC 1 ; 


BO 


3F 




86 1 




BCE 


INDONE 


CAB3: 


C9 


8B 




862 




CMP 


0$8B 


CAB b: 


DO 


02 




863 




ONE 


NOTK 


CAB 7: 


A9 


DB 




864 
865 


NOTK 


LDA 


tf$DB 


CAB9: 


C9 


8) 




866 




CMP 


f'$81 


CABU: 


DO 


OD 




867 




BNE 


NTSHFT 


CARD: 


BD 


38 


07 


868 




LDA 


FLAGS, X 


CACO: 


49 


40 




869 




FOR 


ffBLCCON 


CAC2: 


9D 


38 


07 


870 




STA 


FLAGS, X 


CAC5: 


2C 


10 


CO 


871 




BIT 


KBDSTRB 


CAC 8: 


18 






872 




CLC 




CAC9: 


60 






873 
874 


NTSHFT 


RTS 




CACA: 


48 






875 




PHA 




CACB: 


BD 


38 


07 


876 




LDA 


FLAGS, X 


CAGE: 


OA 






877 




ASL 




CACF: 


OA 






878 




ASL 




CADO: 


68 






879 




PLA 




CADI: 


90 


II' 




880 




BCC 


INDONE 


CAD 3: 


C9 


BO 




881 




CMP 


//$B0 


CAD 5: 


90 


IB 




882 




BLT 


INDONE 


CAD 7: 


2C 


63 


CO 


883 




BIT 


$C063 


CADA: 


30 


14 




884 




BMI 


NOSHIFT 


CADC: 


C9 


80 




885 




CMP 


#"0" 


CADE : 


FO 


OE 




886 




BEO 


ZERO 


CAEO: 


C9 CO 




887 




CMP 


,r@" 


CAE2: 


no 


02 




888 




BNE 


N0T@ 


CAE4: 


A9 


DO 




889 
890 


N0T(3 


LDA 


f«p.. 


CAE6: 


C9 


DB 




891 




CMP 


//"|" 


CAE8: 


90 


08 




892 




liLT 


INDONE 


CAEA: 


29 


CF 




893 




AND 


iC$CF 


CAEC: 


DO 


04 




894 
89^ 


ZERO 


BNE 


INDONE 


CAEE: 


A9 


DD 




896 
897 


NOSHIFT 


LDA 


//"|" 


CAFO: 


09 


20 




898 
899 


IN DONE 


ORA 


//$20 


CAF2: 


48 






900 




PHA 




CAF3: 


29 


7F 




901 




AND 


tf$7F 


CAF5: 


9D 


B8 


05 


902 




STA 


BYTE.X 


CAF8: 


68 






903 




PLA 




CAF9: 


38 






904 




SEC 





SAVE KEY 

IF LOWERCASE THEN SET 

THE LOWERCASE KEYBOARD FLAG 



IF LOW ERKEY BOARD FLAG IS SET 
THEN ACCEPT KEY UNMODIFIED 

RECOVER KEY 

CHECK FOR CONTROL K 

SUBSTITUTE A RIGHT BRACKET 

CHECK FOR CONTROL A 

TOGGLE UPR/LWR CONVERT FLAG 



CLEAR KEYBOARD STROBE 
REJECT KEY 



SAVE KEY 

CHECK UPR/LWR CONVERT FLAG 



RESTORE CHARACTER 

DON'T CONVERT IF FLAC CLEAR 



CONVERT ONLY ALPHA KEYS 



SHIFT KEY UP, SEND AS LOWERCASE 
ZERO BECOMES "}" 



[ \ ] ~ _ BECOME 
K L M N 



CONVERT TO LOWERCASE 

■UPLICATE KEY 
STRIP OFF HICH BIT 
SAVE FOR PASCAL 
RECOVER FOR BASIC 
ACCEPT KEY 











906 


RTS9 






CAFA: 


60 






907 
908 
9§9 
910 


; 


RTS 

DS 


C000+SBOO-* 


CBOO: 


2C 


CB 


FF 










CB03: 


7f 






911 
912 
913 
914 


PWRITE 


HEX 


2CCBFF70 


CBi4: 


90 


B8 


05 


915 

916 


PWRITE 1 


STA 


BYTE ,X 


CB07: 


20 


18 


C8 


917 




JSR 


PSTART 


CBOA: 


20 


06 


CE 


918 




JSR 


0UTPT1 


CBOD: 


20 


09 


C8 


919 
920 


CSRMOV 


JSR 


EXLT 


CBIO: 


AC 


F8 


06 


921 




LDY 


NO 


CB13: 


A9 


OF 




922 




LDA 


#$0F 


CB15: 


99 


80 


CO 


923 




STA 


REGSEL,Y 


CB18: 


BD 


B8 


04 


924 




LDA 


CHORZ,X 


CB1B: 


4C 


27 


CB 


925 
926 
927 
928 


SHUTUP 


JMP 

DS 


SSKLP 

C000+SB1K-* 


CB1E: 


A9 


FF 




929 




LDA 


//$FF 


CB20: 


8D 


FF 


CF 


930 




STA 


SCFFF 


CB23: 


60 






931 




RTS 




CB24: 


4C 


IE 


CB 


932 
933 
934 


A 

SSKLP 


JMP 


SHUTUP 


CB27: 


CD 


F8 


• 5 


935 




CMP 


PWDTH 


CB2A: 


BO 


15 




936 




BCS 


RTS6 


CB2C: 


7D 


B8 


03 


937 




ADC 


BASEL, X 


CB2F: 


99 


81 


CO 


938 




STA 


DATA , Y 


CB32: 


A 9 


OE 




939 




LDA 


*SOE 


CB34: 


99 


80 


CO 


941 




STA 


REGSEL,Y 


CB37: 


A9 


00 




941 




LDA 


II $00 


CB39: 


7D 


38 


•4 


942 




ADC 


BASEH ,X 


C83C: 


29 


IF 




943 




AND 


#5 IF 


CB3E: 


99 


81 


CO 


944 
945 


RTS6 


STA 


DATA,Y 


C841 : 


60 






946 
947 
948 
949 


PREAD 


RTS 




CB42: 


20 


18 


C8 


950 
951 


KEYtN 


JSR 


PSTART 


CB45: 


E6 


4E 




952 




LNC 


RNDL 


CB47: 


DO 


02 




953 




BNE 


KEYLN2 


CB49: 


E6 


4F 




954 
955 


KEYIN2 


LNC 


RNDH 


CB4B: 


AD 


00 


CO 


956 




LDA 


KBD 


CB4E: 


10 


F5 




957 




BPL 


KEYIN 


CB50: 


20 


9C 


CA 


958 




JSR 


KEYSTAT 


CB53: 


90 


Fi 




959 




BCC 


KEYIN 


CB55: 


2C 


It 


CO 


96f 
961 


RTSO 


BIT 


KBDSTRB 



CALCULATE TEMPORARIES 



GET DEVLCE INDEX 
SELECT FOR 

CURSOR ADDRESS LOW 
CALCULATE ADDRESS 



SAVE ADDRESS 
SELECT RECLSTER FOR 
CURSOR ADDRESS HLGH 



SAVE ADDRESS 



CALCULATE TEMPORARIES 
UPDATE BASIC RANDOM NUMBER 



POLL KEYBOARD 

LOOP UNTIL KEY LS STRUCK 

CHECK STATUS AND CONVERT KEY 

REJECTED, TRY AGAIN 

CLEAR KEYBOARD STROBE 



— F.19— 



CB58: 


60 






962 
963 


RDKEY 


RTS 




CB59: 


20 


10 


CB 


964 




JSK 


CSRjMOV 


CB5C: 


20 


45 


CB 


965 




JSR 


KEYIN 


CB5F: 


48 






966 




PHA 




CI360: 


A9 


OK 




967 




LDA 


II SOF. 


CB62: 


AC 


F8 


06 


96 8 




LDY 


NO 


CB65: 


99 


80 CO 


969 




STA 


REGSEL, 


C668: 


A9 


FF 




970 




LDA 


#$Ff 


CD6A: 


99 


81 


CO 


97) 




STA 


DATA , Y 


CB6D: 


68 






972 




PLA 




CB6G : 


60 






973 
974 
975 


CHKPUT 


RTS 




CB6F: 


BO 


0* 




976 




BCS 


WSKIP 


CB71 : 


9D 


00 


cc 


977 




STA 


DISPO,X 


CB74: 


60 






978 
979 


WSKTP 


RTS 




CB75: 


9D 


00 


CI) 


980 




STA 


DtSPt ,X 


CB78: 


60 






981 
982 
983 


CAPSLK 


RTS 




CB79: 


C9 


F.O 




984 




CMP 


ffSEi 


CB7B: 


90 


02 




985 




BLT 


RTS 5 


CB7D: 


29 V\ 




986 




AND 


ffSDF 










987 


RTS5 







PUT CURSOR ON SCREEN 
GET KEY FROM KEYBOARD 



REMOVE CURSOR 



WRITE TO SECOND PAGE IF C=l 
PUT CHARACTER IN SCREEN MEMORY 



PUT CHARACTER IN SCREEN MEMORY 



IF LOWER CASE CHARACTER 
CONVERRT IT TO UPPERCASE 



-F.20— 











990 


******* 


****** 


******** 












991 


* 




* 












992 


* GO TO XY 


* 












993 


* OLD 


LEAD IN * 












994 


* RAW 


MODE 


* 












995 


* VIDEO FORMAT * 












996 


* CHARACTER 


ATTR . * 












997 


* 




* 












998 


************* 


******** 












999 


* 
















1000 COXY 








CB80: 


A9 


31 




1001 




LDA 


#S3I 




CB82: 


2C 






1002 
1003 


LEADIN 


HEX 


2C 




CB83: 


A9 


33 




1004 




LDA 


II $22 




CB85: 


2C 






1005 
1006 


RAW 


HEX 


2C 




CB86: 


A9 


34 




1007 




LDA 


//S34 




CB88: 


2C 






1008 
1009 


VIDEO 


HEX 


2C 




CB89: 


A9 


35 




1010 




LDA 


#$35 




CB8B: 


2C 






1011 
1012 


SETATR 


HEX 


2C 




CB8C: 


A9 


36 




1013 




LDA 


*$36 




CB8E: 


9D 


B8 


06 


1014 




STA 


POFF.X 




CB91: 


60 






1015 
1016 
1017 
1018 


* 
******* 


RTS 


******** 












1019 


* HIGHLIGHT 


* 












1020 


* LOWLIGHT 


* 












1021 


* FLAG 


SET 


* 












1022 


* FLAG 


CLEAR 


* 












1023 


* 




* 












1024 


********************* 












1025 


* 
















1026 


HLLITE 








CB92: 


A9 


3F 




1027 




LDA 


0S3F 




CB94: 


85 


32 




1028 




STA 


INVFLG 




CB96: 


A9 


80 




1029 
1030 


FLGSET 


LDA 


0BINV 


; SET INVERSE FLAG BIT 


CB98: 


ID 


38 


07 


1031 




ORA 


FLAGS, X 


; SET FLAC 8IT 


CB9B: 


DO 


09 




1032 
1033 
1034 


* 
LOLITE 


BNE 


FLGSAV 




CB9D: 


A9 


FF 




1035 




LDA 


/7$FF 




CB9F: 


85 


32 




1036 




STA 


INVFLG 




CBA1: 


A9 


7F 




1037 
1038 


FLGCLR 


LDA 


0BINV!$FF 


; CLEAR INVERSE FLAC BIT 


CBA3: 


3D 


38 


07 


1039 

1040 


FLGSAV 


AN! 


FLAGS, X 


; CLEAR FLAG BIT 


CBA6: 


9D 


38 


07 


1041 




STA 


FLACS,X 


; SAVE FLAG BIT 


CBA9: 


60 






1042 




RTS 







-F.21- 











1044 


******** 


***** 


******** 










1045 


* 




* 










1046 


* CLEAR 


SCREEN * 










1047 


* HOME 


CURSOR * 










1048 


* CLEAR 


TO EOP * 










1049 


* 




* 










1050 


******** 


***** 


******** 










1051 


* 














1052 


CLSCRN 






CBAA: 


38 






1053 




SEC 




CBAB: 


90 






1054 
1055 


HOME 


HEX 


90 


CBAC: 


18 






1056 




CLC 




CBAD: 


20 


F9 


CB 


1057 




JSR 


CR 1 


CB60: 


90 


38 


05 


10 58 




STA 


CVERT,X 


CBB3: 


90 


)C 




1059 




BCC 


JVTAB 


CBB5: 


20 


F,6 


cc 


1060 
1061 
1062 
1063 


* 
CLREOP 


JSR 


VTAB 


CBB8: 


20 


AC 


cc 


1064 




JSR 


CLREOL 


CBBB: 


BD 


38 


05 


1065 
1066 


CLEtPl 


LDA 


CVERT,X 


CBBF: 


69 


00 




1067 




ADC 


0SOO 


C8C0: 


CD 


F8 


04 


1068 




CMP 


HEICHT 


CBC3: 


BO 


OC 




1069 




bge 


JVTAB 


CBC5: 


48 






1070 




PHA 




CBC6: 


20 


E9 


CC 


1071 




JSR 


VTABZ 


CBC9: 


AO 


00 




1072 




LDY 


tfSOO 


CBCBr 


20 


BE 


CC 


1073 




JSR 


CLE0L7. 


CBCE: 


68 






1074 




PL A 




CBCF: 


BO 


ED 




1075 
1076 


JVTAB 


UCS 


CLE0P1 


CBD1 : 


4C 


£6 


cc 


1077 
1078 


* 


JMP 


VTA8 










1079 


******** 


***** 


******** 










1080 


* 




* 










1081 


* BELL 




* 










1082 


* 




* 










1083 


******** 


************* 










1084 


* 














1085 


BELL 






CBD4: 


AO 


60 




1086 
1087 


BELLI 


LDY 


0S6O 


CBD6: 


A2 


80 




1088 

1089 


BELL 2 


LDX 


0S8O 


CBD8: 


CA 






1090 




DEX 




CBD9: 


00 


FD 




1091 




BNE 


BELL2 


CBDB: 


AD 


30 


CO 


1092 




LDA 


SPKR 


CBDE: 


88 






1093 




DEY 




CBUF: 


DO 


F5 




1094 
1095 


CETX 


BNE 


BELLI 


CBE1: 


A£ 


F8 


07 


1096 




LDX 


MSLOT 


CBE4: 


60 






1097 




RTS 





SET CHOR?. - 
SET CVERT - 
VTAB, EXtT IF C = 



CLEAR TO END OF CURRENT LINE 



NEXT LINE 

DONE? 

YES, EXIT TO VTAB 

SAVE LINE NUM. 

VTAB 

START AT BEGINNING OF LINE 

CLEAR TO END OF LINK 

CARRY IS ALWAYS SET 



CBE5: 20 EB CB 
CBE8: 4C 1 6 CC 



CBEB: 
CBEE: 
CBF1; 



BC B8 04 
CC F8 05 

BO 33 



CBF3: 60 



CBF4: BD B8 05 

CBF7: 30 2D 

CBF9: A9 00 

CBFB: 9D B8 04 

CBFE: 60 



CBFF: 85 35 

CC01: 20 EB CB 

CC04: BC B8 04 

CC07: 20 78 C9 

CCOA: A 5 32 

CCOC: 29 80 

CCOE: 45 35 

COO: 20 6F CB 

CC13: A£ F8 07 



CC16: 
CC19: 
CC1C: 
CC1E: 
CC21 : 
CC24: 



FE B8 04 
BD B8 05 
10 D5 
BD B8 04 
CD F8 05 
90 CD 



1099 

I 100 
1101 
1102 
1103 
1104 
1105 
1106 
1107 
1108 
1109 
1110 
ill I 

II 12 
1113 
1114 
LI 15 
1116 
1117 
1118 
I 119 
1120 
1121 
1122 
1123 
1124 
1125 
1126 
L127 
1128 
1129 
1130 
1131 
1132 
U33 
1134 
1135 
1136 
1 137 
1138 
1139 
1140 
1 141 
1142 
1 143 
1144 
1145 



ADVANCE 

STORE ADVANCE 

CARRIAGE RETURN 

LINEFEED 

SCROLL 

CLEAR TO EOL 



JSR 
JMP 



LDY 

CPY 
BCS 

RTS 



PREADV 
AOVNCE 



CHORZ, 
PVJDTH 
CRLF 



LDA 


BYTE.X 


BMl 


CRLF 


LDA 


fr$00 


STA 


CHORZ, X 


RTS 




STA 


XSAVE 


JSR 


PREADV 


LDY 


CHORZ, X 


JSR 


PACSEL 


LDA 


INVFLG 


AND 


fl$80 


EOR 


XSAVE 


JSR 


CHRPUT 


LDX 


MS LOT 


INC 


CHORZ, X 


LDA 


BYTE,X 


BPL 


RTS 8 


LDA 


CHORZ, X 


CMP 


PWDTH 


BCC 


RTS8 



DO PREADVANCE FOR PASCAL 
FINISH ADVANCING 



IF BEYOND SCREEN WIDTH 
THEN DO A CR 



IF FROM BASIC 

DO LINEFEED AFTER CR 



SAVE CHARACTER 

DO PREADVANCE FOR PASCAL 



COMPUTE SCREEN ADDRESS 
COMBINE INVFLG WITH CHARACTER 



PUT CHARACTER ON SCREEN 
RESTORE X 



ADVANCE CHORZ 
IF PASCAL, EXIT 



IF CHORZ > SCREEN WIDTH THEN 
DO A CRLF 



— F.23— 



CC26: 20 F9 CB 

CC29: FE 38 05 

CC2C: BD 38 05 

CC2F: CD F8 04 

CC32: 90 9D 

CC34: DE 38 05 

CC37: BD 38 07 

CC3A: 29 07 

CC3C: A8 

CC3D: B9 3A CF 

CC/.O: 18 

CC41: 7D 38 06 

CC44: AC 78 04 

CC47: CO CO 

CC49: DO 02 

CC4B: 29 7F 



CC4D: 
CC50: 
CC51: 
CC54: 
CC57: 
CC59: 
CC5C: 
CC5F: 
CC61: 
CC64: 
CC66: 
CC69: 
CC6C: 
CC6E: 
CC71: 
CC74: 
CC75: 
CC76: 
CC79: 
CC7B: 
CC7E: 



9D 38 #6 
18 

20 04 CD 
AC F8 06 
A9 OD 
99 80 CO 
BD B8 03 
29 FO 
99 81 CO 
A9 OC 
99 81 CO 
BD 38 04 
29 OF 
99 81 CO 
AC F8 04 
88 
98 

20 E9 CC 
AO 00 
20 BE CC 
BO 66 



1147 CRLF 

1148 

1149 LF 

1150 

1151 

1152 

1153 

1154 

1155 * 

1156 

1157 

1158 

1159 

1 160 

1161 

1162 

1163 

1164 

1165 

1166 N512 

1167 

1168 

1169 

1170 

1171 

1172 

1173 

1174 

1175 

1176 

1177 

1178 

1179 

1180 

1181 

1182 

1183 

1184 

1185 

1186 

1187 



INC 
LDA 
CMP 
BCC 
DEC 



CVERT.X 

CVERT.X 

HEIGHT 

JVTAB 

CVERT.X 



LDA FLAGS, X 

A.ND tfBFORMT 

TAY 

LDA SCLTBL.Y 

CLC 

ADC START, X 

LDY MODE 

CPY //MBSVS 

BNE N 5 1 2 

AND f/$7? 



STA 
CLC 
JSR 
LDY 
LDA 
STA 
LDA 
AND 
STA 
LDA 
STA 
LDA 
AND 
STA 
LDY 
DEY 
TYA 
JSR 
LDY 
JSR 
BCS 



START, X 

BASCALC 

NO 

//SOD 

RECSEL.Y 

BASEL, X 

(7SF0 

DATA.Y 

//$0C 

RF.CSEL.Y 

BASEH.X 

rf'SOF 

DATA , Y 

HEIGHT 



VTABZ 
ffSOO 
CLEOLZ 
VTAB 



NEXT LINE 
BOTTOM? 



NO, EXIT 

FIX CVERT AND SCROLL 



INCREMENT START ADDRESS 

BY VALUE BASED ON SCREEN FORMAT 



512 ADDRESSING MODE HAS LESS 
SCREEN AREA 



SAVE NEW START VALUE 
CALCULATE THE START ADDRESS 



SELECT START ADDRESS LOW REG. 

SAVE START ADDRESS LOW 

SELECT START ADDRESS HIGH REG. 



SAVE START ADDRESS HIGH 
PUT HEIGHT- 1 INTO A 



VTAB 

CLEAR BOTTOM LINE 











1189 


FIXBUF 








CC80: 


A5 


33 




1190 




LDA 


PROMPT 


FIX INPUT BUFFER IF PROMPT 


CC82: 


C9 


DD 




1191 




CMP 


tr ]" 


IS |, >, OR * 


CC84: 


FO 


08 




1192 




BEQ 


FIXIT 




CC86: 


C9 


BE 




1193 




CMP 


try 




CC88: 


FO 


04 




1194 




BEQ 


FIXIT 




CC8A: 


C9 


AA 




1195 




CMP 


//"*" 




CC8C: 


DO 


IE 




1196 
1197 


FIXIT 


BNE 


CLREOL 




CC8E: 


A2 


00 




1198 




LDX 


ti $00 


START AT BEGINNING 


CC90: 


AO 


00 




1199 
1200 


FL00P1 


LDY 


0$OO 


TURN QUOTE FLAG OFF 


CC92: 


BD 


00 


02 


1201 




LDA 


IN,X 


GET CHARACTER 


CC95: 


A 8 






1202 




PKA 






CC96: 


C9 


A2 




1203 




CMP 


0$A2 


IS IT A QUOTE? 


CC98: 


DO 


01 




1204 




BNE 


NTQTE 


NO, SKIP 


CC9A: 


C8 






1205 
1206 


NTQTE 


INY 




TOGGLE QUOTE FLAG 


CC9B: 


98 






1207 




TYA 




PUT QUOTE FLAG IN CARRY 


CC9C: 


AA 






1208 




LSR 






CC9D: 


68 






1209 




PLA 




GET CHARACTER 


CC9E: 


BO 


06 




1210 




BCS 


NXTIN 


CONVERT TO UPPERCASE IF 


CCAO: 


20 


79 


CB 


1211 




JSR 


CAPSLK 


QUOTE FLAG IS OFF 


CCA 3: 


9D 


00 


02 


1212 
1213 


NXTIN 


STA 


IN,X 


SAVE CHARACTER 


CCA6: 


E8 






1214 




[NX 




NEXT BUFFER POSITION 


CCA 7 : 


DO 


E9 




1215 




BNE 


FL00P1 


CONTINUE UNTIL DONE 


CCA 9: 


A£ 


F8 


07 


1216 
1217 
1218 




LDX 


MSLOT 


RECOVER X 










1219 CLREOL 








CCAC: 


BC 


B8 


04 


1220 




LDY 


CHORZ.X 


START AT CHORZ 


CCAF: 


AC 


BE 


CC 


1221 
1222 
1223 


* 
CLE0L2 


JMP 


CLEOLZ 




CCB2: 


C8 






12 24 




INY 




ADVANCE POSITION 


CCB3: 


4A 






1225 




LSR 




RECOVER CARRY 


CCB4: 


20 


6F 


CB 


1226 




JSR 


CHRPUT 


PUT SPACE ON SCREEN 


CCB7: 


2A 






1227 




ROL 




SAVE CARRY 


CCB8: 


E8 






1228 




INX 




NEXT PAGE INDEX 


CC89: 


DO 


09 




1229 




BNE 


CLSKIP 


IF 0, SELECT NEW PAGE 


CCBB: 


AE 


F8 


07 


1230 

1231 


CLEOLZ 


LDX 


MSLOT 




CCBE: 


20 


78 


C9 


1232 




JSR 


PACSEL 


CALCULATE SCREEN ADDRESS 


CCC1: 


A9 


20 




1233 




LDA 


#$20 


USE A SPACE 


CCC3: 


2A 






1234 
1235 


CLSKIP 


ROL 




SAVE CARRY 


CCC4: 


CC 


78 


05 


1236 




CPY 


SWDTH 


DONE? 


CCC7: 


90 


E9 




1237 




BLT 


CLE0L2 


NO, CONTINUE LOOP 


CCC9: 


AC 


El 


CB 


1238 




JMP 


CETX 


RECOVER X 











1240 


** 


***** 


****** 


********* 










124) 


* 






* 










1242 


* 


BACKSPACE 


* 










1243 


* 


REVERSE LINEFEED * 










1244 


* 


VERTICAL TAB * 










1245 


* 






* 










1246 


** 


***** 


****** 


********* 










1247 


* 
















1248 


RS 








CCCC: 


BD 


R8 


04 


1249 






LDA 


CH0R2.X 


CCCF: 


KO 


04 




1250 






BEQ 


ENDUP 


CCDI: 


DF. 


B8 


04 


125J 






DEC 


CHORZ.X 


CCD4: 


60 






1252 
1253 


* 




RTS 












1254 


ENDUP 






CCD5: 


AD 


F8 




1255 






LDA 


PWDTH 


CCD8: 


9D 


08 


04 


12 56 






STA 


CHOKZ.X 


CCDB: 


UE 


B8 


04 


1257 
125B 


* 




DEC 


CHORZ,X 










1259 


* 


MOVE 


CURSOR 


UP 










1260 


* 
















1261 


UH 








CCDt: 


BB 


38 


U5 


1262 






LDA 


CVERT,X 


CCK 1 : 


FO 


.'>■ 




1263 






BEQ 


RTS 1 


CCE3: 


UE 


38 


5 


1264 
1265 


* 




DEC 


CVERT,X 










1266 


* 


CALCULATE NEW BASF. A 










i267 


* 
















1268 


VTAB 






CCK A: 


BD 


38 


Ob 


1269 






LDA 


CVEk!\X 










1270 


VTABZ 






CCP.9: 


80 


78 


o; 


1271 






STA 


TEMPX 


CCF.C : 


BD 


3H 


7 


1272 






LDA 


FLACS.X 


CCKF: 


29 


7 




1273 






AND 


flllftlRMT 


CCr 1 : 


AB 






1274 






TAY 




CCK2: 


B9 


42 


CF 


1275 






LDA 


KULT8L.Y 


CCK 5: 


AR 






1276 






TAY 




CCF6: 


AD 


78 


7 


1277 






: D/ 


TEM PX 


CCF9: 


CA 






1278 






ASL 




CCFA: 


GA 






1279 






ASL 












128# 


VTLOOH 






CCFB: 


6D 


78 


07 


1281 






ADC 


TEMPX 


CCFE: 


88 






1282 






DF.Y 




CCKF: 


DO 


FA 




1283 






BNE 


VTLOOP 


CD01 : 


7D 


38 


06 


1284 






ADC 


START, X 










1285 


BASCALC 






CD04 : 


AC 


78 


04 


1286 






LDY 


MODE 


CD07: 


48 






1287 






PHA 




Cf*08: 


6A 






1288 






ROR 




CD09: 


CO CO 




1289 






CPY 


flMRSVS 


CDOB: 


DO 


02 




1290 






BNE 


NT512 


CDOD: 


29 


7F 




1291 






AND 


II $ 7F 










1292 


NT512 






CD OF : 


4A 






1293 






LSR 




CDIO: 


4A 






1294 






LSR 




CD 1 1 : 


4A 






1295 






LSR 




CD12: 


09 


20 




1296 






ORA 


*S20 



; CO TO END OF LINK 



REVERSE LINEFEED LF NOT AT TOP 



GET VERTICAL POSITION 



; MULTIPLY VERTICAL POSITION 
; BY FOUR 



; MULTIPLY BY 5, 6, 8, OR 10 



ADD IN START 
M LT'IPLY BY ] f> 



CAN'T USE HIC-H BIT IN 

512 BYTE BLOCK ADDRESSING MODE 



; FOOL THE APPLE //e 



CD 14: 


9D 


38 


04 


1297 


STA 


BASEH 


,x 


CD 1 7 : 


68 






1298 


PLA 






CD 18: 


OA 






1299 


ASL 






CD19: 


OA 






1300 


ASL 






CD1A: 


OA 






1301 


ASL 






CI) I B : 


OA 






1302 


ASL 






CD1C: 


9D 


B8 


03 


1303 


STA 


BASEL 


,x 


CD1F: 


AD 


F8 


05 


1304 


LDA 


PWDTH 




CD22: 


C9 


84 




1305 


CMP 


0132 




CD24: 


1)0 


OD 




1306 


BNE 


RTS1 




CD26: 


A9 


OE 




1307 


LDA 


/;soe 




CD28: 


70 


B8 


03 


1308 


ADC 


BASEL 


,x 


CD2B: 


9D 


B8 


03 


1309 


STA 


BASEL 


,x 


C»2E: 


90 


03 




1310 


BCC 


RTS1 




CD30: 


FE 


38 


04 


1311 

1312 RTS1 


LNC 


BASEH 


,x 


CD33: 


60 






1313 


RTS 







IF PRINTED SCREEN WIDTH » 132 
THEN ADD 1 4 TO THE BASE ADDRESS 



— F.27— 











1315 


FORMAT 






CD3A: 


29 


OF 




1316 




AND 


0$OF 


CD36: 


DO 


OF 




1317 
1318 


PRO 


BNE 


FMT1 


CD38: 


AD 


58 


CO 


1319 




LDA 


$C058 


CD3B: 


AC 


F8 


06 


1320 




LDY 


NO 


CD3E: 


A9 


3F 




1321 




LDA 


//MBSVS! 


CDAO: 


2D 


78 


OA 


1322 




AND 


MODE 


CDA3: 


8D 


78 


OA 


1323 




STA 


MODE 


CDA6: 


60 






132A 
1325 


FMT1 


RTS 




CDA7: 


A8 






1326 




TAY 




CDA8: 


A9 


F8 




1327 




LDA 


C/BFORMT 


CDAA: 


20 


A3 


CB 


1328 




JSR 


FLGCLR 


CDAD: 


88 






1329 




DEY 




CDAE: 


98 






1330 




TYA 




CDAF: 


29 


07 




1331 




AND 


//BFORMT 


CD51: 


20 


98 


CB 


1332 




JSR 


FLGSET 


CD5A: 


AC 


6F 


C8 


1333 
133A 
1335 


* 
GOTOX 


JMP 


NEWFMT 


CD57: 


38 






1336 




SEC 




CD58: 


E9 


20 




1337 




SBC 


//$20 


CD5A: 


29 


7F 




1338 




AND 


0$7F 


CD5C: 


8D 


78 


07 


1339 




STA 


TEMPX 


CD5F: 


60 






13A0 
13A1 
13A2 


* 

GO TOY 


RTS 




CD60: 


38 






13A3 




SEC 




CD61: 


E9 


20 




13AA 




SBC 


//$20 


CD63: 


29 


7F 




13A5 




AND 


0$7F 


CD65: 


CD 


F8 


OA 


13A6 




CMP 


HEIGHT 


CD68: 


BO 


03 




13A7 




BGE 


BADY 


CD6A: 


9D 


38 


05 


13A8 
13A9 


BADY 


STA 


CVERT.X 


CD6D: 


AD 


78 


07 


1350 




LDA 


TEMPX 


CD70: 


CD 


F8 


05 


1351 




CMP 


PWDTH 


CD73: 


BO 


03 




1352 




BGE 


BADX 


CD75: 


9D 


B8 


OA 


1353 
135A 


BADX 


STA 


CHORZ.X 


CD78: 


AC 


E6 


CC 


1355 
1356 
1357 


* 
LEAD 


JMP 


VTAB 


CD7B: 


A8 






1358 




PHA 




CD7C: 


A9 


BO 




1359 




EOR 


fl$B0 


CD7E: 


C9 


OA 




1360 




CMP 


0$OA 


CD80: 


68 






1361 




PLA 




CD81: 


90 


03 




1362 
1363 


JSTA.DV 


BLT 


DOVTZ 


CD83: 


AC 


FF 


CB 


136A 
1365 


DOVTZ 


JMP 


STOADV 


CD86: 


A9 


98 




1366 




EOR 


398 


CD88: 


AC 


F6 


CD 


1367 
1368 
1369 


* 
RAWVID 


JMP 


CONTROL 


CD8B: 


C9 


AO 




1370 




CMP 


tf$AO 


CD8D: 


BO 


FA 




1371 




BGE 


JSTADV 



IF FORMAT THEN 
EXIT TO AO COLUMNS 



OLD SOFT VIDEO SWITCH 



AO COLUMN VIDEO 



; PUT FORMAT - 1 IN FLAGS 



SAVE X POSITION 



SUBTRACT $20 FROM Y POSITION 
ESTABLISH CVERT 



ESTABLISH CH0R2 



GO TO NEW POSITION 



IF 0, 1, 2, OR 3 THEN DO 
V[DEOTERM LEAD FUNCTIONS 



PUT CHARACTER ON SCREEN 



ALLOW CHARACTERS >= SPACE 



-F.28- 



C08F: 


C9 


8U 




1372 


CMP 


fl$8D 


CD91: 


PO 


5B 




1373 


BEQ 


VtDOUT 


C093: 


C9 


8R 




1374 


CMP 


0$8B 


CD 95: 


90 


57 




1375 


BLT 


VIDOUT 


CD97: 


60 






1376 

1377 * 

1378 LOATR 


RTS 




CD 98: 


48 






1379 


PHA 




CD99: 


BD 


38 


07 


13 80 


LDA 


FLAGS ,X 


CO 9C : 


29 


07 




1381 


AND 


0BFORMT 


CD9E: 


A8 






1382 


TAY 




CD9F: 


68 






1383 


PLA 




CDAO: 


59 


44 


C9 


1384 


EOR 


ATRTBL.Y 


CDA3: 


29 


07 




1385 


AND 


ff$07 


CDA5: 


8D 


78 


07 


1386 


STA 


TEMPX 


CDA8: 


60 






1387 

1388 * 

1389 HIATR 


RTS 




CDA9: 


29 


03 




1390 


AND 


tf$03 


CDAB: 


OA 






1391 


ASL 




CDAC: 


OA 






1392 


ASL 




CDAD: 


OA 






1393 


ASL 




CDAE: 


OA 






1394 


ASL 




CDAF: 


OD 


78 


07 


1395 


ORA 


TEMPX 


CDB2: 


AC 


F8 


06 


1396 


LDY 


NO 


CDB5: 


99 


83 


CO 


1397 


STA 


ATTREG.Y 


CDB8: 


60 






1398 


RTS 





ALLOW CR 

ALLOW CHARACTERS <= LF 



COMPUTE CHARACTER SET 



COMBINE ATTRIBUTE WITH 
CHARACTER SET 



SAVE LOW ATTRIBUTE 



PUT ATTRIBUTE IN HIGH NYBBLE 



COMBINE WITH LOW ATTRIBUTE 
SET NEW ATTRIBUTES 











1400 


* PERFORJ-1 ESCAPE FUNCTIONS 










1401 


* 














1402 


ESCNEW 






CDB9 


20 


E2 


CD 


1403 




JSR 


liS CRD ; 


CDBC 


C9 


09 




14 04 




CMP 


0509 ; 


CDBE 


BO 


03 




1405 




BCE 


ESC 2 ; 


CDCO 


4C 


34 


CD 


1406 
1407 


ESC2 


JMP 


FORMAT ; 


CDC 3 


49 


70 




1408 




EOR 


'/$70 ; 


CDC5 


C9 


08 




1409 




CMP 


'/$08 


CDC 7 


90 


2D 




1410 
141 1 


ESC NOW 


BLT 


CONTROL ; 


CDC9 


C9 


OF 




1412 




CMP 


ifSOK ; 


CDCB 


BO 


20 




1413 




BCE 


RTS3 ; 


CDCD 


C9 


09 




1414 




CMP 


ft $09 ; 


CDCF 


90 


1C 




1415 




BLT 


RTS3 ; 


CDD1 


C9 


OC 




1416 




CMP 


//$0C ; 


CDD3 


FO 


18 




1417 




BEQ 


RTS 3 ; 


CDD5 


A 8 






1418 




TAY 




CDD6 


B9 


4C 


CE 


1419 




LDA 


XLTBL-$09,Y 


CDD9 


20 


F6 


CD 


1420 




JSR 


CONTROL ; 


CDDC 


20 


E2 


CD 


1421 




JSR 


ESCRD ; 


CDDF 


4C 


C3 


CD 


1422 
1423 
1424 


F.SCRD 


JMP 


ESC 2 ; 


CDE2 


20 


59 


CB 


1425 




JSR 


RDKEY 


CDE5 


20 


79 


CB 


1426 




JSR 


CAPSLK 


CDE8 


9D 


B8 


05 


1427 




STA 


BYTE.X 


CDEB 


49 


BO 




1428 
1429 


RTS3 


EOR 


/'$B0 


CDED 


60 






1430 
1431 
1432 


* 
VIDOUT 


RTS 




CDEE 


C9 


AO 




1433 




CMP 


//SaO ; 


CDFO 


BO 


91 




1434 




BCE 


JSTADV 


CDF2 


C9 


87 




1435 




CMP 


0S87 ; 


CDF4 


90 


OF 




1436 
1437 


CONTROL 


BLT 


RTS4 ; 


CDF6 


OA 






1438 




ASL 




CDF 7 


A8 






1439 




TAY 




CDF8 


B9 


5B 


CE 


1440 




LDA 


CTLTBL+l.Y ; 


CDFB 


48 






1441 




PKA 




CDFC 


B9 


5A 


CE 


1442 




LDA 


CTLTBL,Y 


CDFF 


48 






1443 




PKA 




CEOO 


BD 


B8 


05 


1444 




LDA 


BYTE.X 


CE03 


09 


80 




1445 
1446 


RTS4 


ORA 


//S80 


CE05 


60 






1447 




RTS 


; 



READ ESCAPR KEY 

IS IT - 8 ? 

NO, TRY OTHERS 

YES, SELECT NEW FORMAT 

IS IT A - F? 

YES, PERFORM FUNCTION 

IS IT >- N? 
YES, EXIT 
IS IT < 1? 
YES, EXIT 
IS IT L? 
YES, EXIT 

; CONVERT TO A, B, C, OR 
PERFORM FUNCTION 
READ NEW ESCAPE KEY 
PROCESS KEY 



OUTPUT CHARACTERS >= SPACE 



PERFORM FUNCTIONS ON 
CONTROL CHARACTERS > CTRL F 



CET FUNCTION ADDRESSES 
AND PUSH THEM ON THE STACK 



DISPATCH T» FUNCTION 











1449 


* GENERAL OUTPUT ROUTINE 










1/.50 


* 














1451 


0UTPT1 






CE06: 


AD 


59 


CO 


1452 




LDA 


SC059 


CE09: 


BC 


B8 


06 


1453 




LDY 


POFF,X 


CROC: 


B9 


82 


CE 


1454 




LDA 


STATE- $ 30, Y 


CEOF: 


9D 


B8 


06 


1455 




STA 


POFF.X 


CE12: 


98 






1456 




TYA 




CE 13 : 


29 


27 




1457 




AND 


#$2 7 


CE15: 


DO 


DF 




1458 
1459 
14 60 
1461 


FIXCSR 


mi 


CONTROL 


CE17: 


A5 


25 




1462 




LDA 


cv 


CE19: 


DD 


38 


05 


1463 




CMP 


CVERT.X 


CElC: 


Ft 


06 




1464 




BEO 


CVOK 


CEIE: 


90 


38 


05 


1465 




STA 


overt, x 


CE21 : 


20 


E6 


CC 


1466 
1467 


CVOK 


JSR 


VTAB 


CE24: 


A5 


24 




1468 




LDA 


CH 


CE26: 


DD 


B8 


04 


1469 




CMP 


CHORZ.X 


CE29: 


BO 


1C 




1470 




BCS 


NCOMMA 


CE2B: 


C9 


11 




1471 




CM P 


(/$[[ 


CE2D: 


BO 


18 




1472 




BCS 


NCOMMA 


CE2F: 


09 


FO 




1473 




ORA 


!1$Y0 


CE31: 


3D 


B8 


04 


1474 




AND 


CHORZ.X 


CE34: 


65 


24 




1475 




ADC 


CH 


CE36: 


CD 


F8 


05 


1476 




CMP 


PWDTH 


CE39: 


90 


•A 




1477 




BCC 


NTEOL 


CE38: 


20 


26 


CC 


1478 




JSR 


CRLF 


CE3E: 


BD 


38 


05 


1479 




LDA 


CVERT.X 


CE4 1 : 


85 


25 




1480 




STA 


CV 


CE43: 


A9 


00 




1481 
1482 


NTEOL 


LDA 


(!$00 


CE45: 


85 


24 




1483 

1484 


N COMMA 


STA 


CH 


CE47: 


DD 


B8 


04 


1485 




CMP 


CHORZ.X 


CE4A: 


90 


03 




1486 




BCC 


RTS2 


CE4C: 


9D 


B8 


04 


1487 
1488 


RTS2 


STA 


CHORZ.X 


CE4F: 


60 






1489 




RTS 





TURN OLD SOFT VIDEO SWITCH ON 
FETCH CURRENT STATE 
; ESTABLISH NEW STATE 

PERFORM CURRENT STATE FUNCTION 



PERFORM VTAB 



PERFORM COMMA TAB 



PERFORM HTAB 









"1491 


* 












1492 


FIXWDTH 






CE50: 


A9 


28 


1493 




LDA 


HO 


CE52: 


85 


21 


1494 




STA 


WNDWDTH 


CE54: 


60 




1495 
1496 


XLTBL 


RTS 




CE55: 


04 


02 01 










CE58: 


FF 


03 


1497 
1498 


* 


HEX 


04O201FFO3 








1499 


** ****** 


*************** 








1500 


* ESCAPE CODES * 








1501 


******** 


***** 


********** 








1502 


* 












1503 


CTLTBL 






CE5A: 


A 9 


CB 


1504 


ESC<3 


DA 


CLSCRN-1 


CE5C: 


E4 


CB 


1505 


ESCA 


DA 


ADVANCE- 1 


CE5E: 


CB 


CC 


1506 


f;scb 


DA 


BS-1 


CE60: 


28 


CC 


1507 


ESCC 


DA 


LF-1 


CE62: 


0D 


CC 


1508 


ESCD 


DA 


UP-1 


CE64: 


AB 


CC 


1509 


ESCE 


DA 


CLREOL-1 


CE66: 


B7 


CB 


1510 
1511 


ESCF 
* 


DA 


CLREOP-l 








1512 


******** 


***** 


********* 








1513 


* CONTROL CODES * 








1514 


******** 


***** 


********* 








1515 


* 






CE68: 


D3 


CB 


1516 


CTLC 


DA 


BELL-1 


CE6A: 


CB 


CC 


1517 


CTLH 


DA 


BS-1 


CE6C: 


57 


CB 


1518 


CTLI 


DA 


RTS 0-1 


CE6E: 


28 


CC 


1519 


CTLJ 


DA 


LF-1 


CE70: 


B7 


CB 


1520 


CTLK 


DA 


CLREOP-l 


CE72: 


A9 


CB 


1521 


CT1.L 


DA 


CLSCRN-1 


CE74: 


F3 


CB 


1522 


CTLM 


DA 


CR-1 


CE76: 


9C 


CB 


1523 


CTLN 


DA 


LOLITE-I 


CE78: 


91 


CB 


1524 


CTLO 


DA 


H1LITE-1 


CE7A: 


57 


CB 


1525 


CTLP 


DA 


RTSO-) 


CE7C: 


57 


CB 


1526 


CTLQ 


DA 


RTS 0-1 


CE7E: 


85 


CB 


1527 


CTLR 


DA 


RAW-1 


CE80: 


57 


CB 


1528 


CTLS 


DA 


RTS 0-1 


CE82: 


57 


CB 


1529 


CTLT 


DA 


RTS 0-1 


CE84 : 


37 


CD 


1530 


CTLU 


DA 


PRO-1 


CE86: 


88 


CB 


1531 


CTLV 


DA 


VtDEO-1 


CE88: 


8B 


CB 


1532 


CTLW 


DA 


SETATR-1 


CE8A: 


57 


CB 


1533 


CTLX 


DA 


RTSO-1 


CE8C: 


AB 


CB 


1534 


CTLY 


DA 


HOHE-1 


CE8E: 


82 


CB 


1535 


CTLZ 


DA 


LEAD1N-1 


CE90: 


57 


CB 


1536 CTL[ 


DA 


RTSO-1 


CE92: 


E4 


C8 


1537 CTL\ 


DA 


ADVANCE- 1 


CE94: 


AS 


CC 


1538 CTL] 


DA 


CLREOL-1 


CE96: 


7F 


CB 


1539 


CTL~ 


DA 


COXY- I 


CE98: 


DD 


CC 


1540 CTL 


DA 


UP-1 








1541 


* 












1542 


******** 


***** 


******** 








1543 


* DISPATCH TABLE * 








1544 


******** 


***** 


******** 








1545 


* 












1546 


DSPTBL 







CE9A: 


ED 


CD 


1547 




DA 


VIDOUT-1 


CE9C: 


56 


CD 


1548 




DA 


GOTOX-1 


CE9E: 


5F 


CD 


1549 




DA 


COTOY- 1 


CEAO: 


7A 


CD 


1550 




DA 


LEAD-1 


CEA2: 


8A 


CD 


1551 




DA 


RAWVID-1 


CEA4: 


33 


CD 


1552 




DA 


FORMAT- 1 


CEA6: 


97 


CD 


1553 




DA 


LOATR-1 


CEA8: 


A8 


CD 


1554 
1555 
1556 


LEADTBL 


DA 


HIATR-1 


CEAA: 


3B 


C8 


1557 


CTLZO 


DA 


RESTART- 1 


CEAC: 


37 


CD 


1558 


CTLZ1 


DA 


PRO-1 


CEAE: 


9C 


CB 


1559 


CTLZ2 


DA 


LOLtTE-1 


CEBO: 


91 


CB 


1560 
1561 
1562 
1563 


CTLZ3 

* 
* 
STATE 


DA 


HIHTE-1 


CEB2: 


30 




1564 




DFB 


$30 


CEB3: 


32 




1565 




DFB 


S32 


CEB4: 


30 




1566 




DFB 


S30 


CEB5: 


30 




1567 




DFB 


$30 


CEB6: 


34 




1568 




DFB 


$34 


CEB7: 


30 




1569 




DFB 


S30 


CEB8: 


37 




1570 




DFB 


$37 


CEB9: 


30 




1571 
1572 
1573 
1574 
1575 
1575 


TABLE 
* 80 X 


DFB 

24 
>» 

>» 


S30 

T80 
HT1 


CEBA: 


7a 




1575 
1575 




HEX 
«< 


7A 


CEBB: 


50 


5D 


1575 
1575 




HEX 
>» 


505D 
SW1 


CEBO: 


38 




1575 
1575 
1575 
15 76 
1576 
1576 
1576 




HEX 

<<< 

<<< 

»> 

DO 

HEX 

ELSE 


38 

X24 

LINEHZf60 

2107181E 


CEBE: 


1C 


00 18 










CEC1: 


1A 




1576 
1576 




HEX 
FIN 


1C00181A 


CEC2: 


00 


08 60 










CEC5: 


08 




1576 
1576 




HEX 
»> 


00086008 
COMMON 


CEC6: 


00 


00 FF 










CEC9: 


00 




1576 
1576 
1576 
1577 
1578 
1578 


* 96 X 


HEX 
<<< 
<<< 
24 
>>> 
»> 


OOOOFFOO 

T96 

HT1 


CECA: 


7A 




1578 
1578 




HEX 
<« 


7A 


CECB: 


60 


68 


1578 




HEX 


6068 



-F.33— 









1578 


»> 


SW1 


CECD: 


38 




1578 
1578 
1578 


HEX 
<<< 

<<< 


38 








1579 


>» 


X24 








1579 


DO 


LLNEHZI60 








1579 


HEX 


2107181E 








1579 


ELSE 




CECE: 


IC 00 


18 








CEDI : 


1A 




1579 
1579 


HEX 

FIN 


ICOOlfllA 


CED 2 : 


00 08 


60 








CED5: 


08 




1579 


HEX 


00086008 








1579 


>» 


COMMON 


CED 6: 


00 00 


FF 








CED 9: 


00 




1579 

1579 
1579 
1580 * 


hex 
<« 
<<< 

160 X 24 


OOOOFFOO 








1581 


»> 


Tl 60 








1581 


>>> 


HT? 


CEDA: 


CA 




1581 
1581 


HEX 
<<< 


CA 


CEDB: 


A0 AB 




1581 


HEX 


A OAR 








1581 


y>> 


SW2 


CEDD: 


4D 




1581 
1581 

1581 


HEX 
<<< 
<<< 


4D 








1582 


»> 


X24 








1582 


DO 


1.INEH2I60 








1582 


HEX 


2 1 7 1 8 ) E 








1582 


ELSE 




CEDE: 


IC 00 


18 








CEE 1 : 


IA 




1582 
1582 


HEX 

FIN 


1C00181A 


CI-E2: 


00 08 


60 








CEE5: 


08 




1582 


HEX 


00086008 








1582 


»> 


COMMON 


CEE6: 


00 00 


FK 








CKE9: 


00 




1582 

1582 
1582 
1583 * 


HEX 
<<< 
<« 

80 X 24 


OOOOFFOO 








1584 


>» 


1-8(1 








1584 


»> 


uti 


CERA: 


7A 




1584 
1584 


HEX 
«< 


7A 


CEEB: 


50 5D 




1586 


HEX 


505D 








1584 


>» 


RWl 


CEED: 


38 




1584 
1584 
1584 


HEX 
<<< 
<<< 


38 








1585 


>» 


X241 








1585 


DO 


HNEHZS60 








1585 


HEX 


2601 1821 








1585 


ELSE 





CEEE: IF 05 18 



-F.34- 



CEF1: 


IC 






1585 
1585 


HEX 
FIN- 


1F05181C 


CEF2: 


03 


OE 


60 








CEF5: 


OC 






1585 
1585 


HEX 
>» 


030E600C 
COMMON 


CEF6: 


00 


00 


FF 








CEF9: 


00 






1585 

1585 

1585 

1586 * 

1587 

1587 


HEX 
<<< 
<<< 
80 X 32 

>» 
>» 


OOOOFFOO 

T80 
HTl 


CEFA: 


7A 






1587 
1587 


HEX 
<<< 


7 A 


CEFB: 


50 


5D 




1587 
1587 


HEX 
>» 


505D 
SWl 


CEFO: 


38 






1587 
1587 
1587 
1588 
1588 
1588 
1588 


HEX 

<<< 

<<< 

»> 

DO 

HEX 

ELSE 


38 

X32 

UNEHZI60 
2F0 12029 


CEFE: 


27 


01 


20 








CFOl: 


24 






1588 
1588 


HEX 
FIN 


27012024 


CF02: 


03 


OB 


60 








CF05: 


OC 






1588 
1588 


HEX 
>» 


0308600C 
COMMON 


CF06; 


00 


00 


FF 








CF09: 


00 






1588 

1588 

1588 

1589 * 

1590 

1590 


HEX 
<<< 
<<< 
80 X 48 

>» 
»> 


oooon-'oo 

T80 
HTl 


CFOA: 


7A 






1590 
1590 


HEX 
<<< 


7A 


CFOB: 


50 


5D 




1590 
1590 


HEX 
>» 


50 5D 

SWl 


CFOD: 


38 






1590 
1590 
1590 
1591 
1591 
1591 
1591 


HEX 

<<< 

<<< 

>>> 

DO 

HEX 

ELSE 


38 

X48 

LLNEHZI60 

4403303B 


CFOE: 


39 


00 


30 








CFJ1 : 


35 






1591 
1591 


HEX 
FIN 


39003035 


CF12: 


03 


07 


60 








CF15: 


08 






1591 
1591 


HEX 
»> 


03076008 
COMMON 


CF16: 


00 


00 


FF 








CF19: 


00 






1591 
1591 
1591 


HEX 
<<< 
«< 


OOOOFFOO 



-R35— 











1592 * 132 X 


24 












1593 


>» 


T132 










1593 


»> 


HT2 


CF1A: 


CA 






1593 
1593 


HEX 
<« 


CA 


CF18: 


AO 


A6 




1593 
1593 


HEX 
»> 


A0A6 
SW2 


CF1D: 


4D 






1593 
1593 
1593 
1594 
1594 
1594 
1594 


HEX 
<« 
<« 
>» 

DO 

HEX 

ELSE 


4D 

X24L 

LLNEHZ! 60 
26011821 


CF1E: 


IF 


05 


18 








CF2I: 


IC 






1594 
1594 


HEX 
FLN 


1F05181C 


CF22: 


03 


OE 


60 








CF25: 


OC 






1594 
1594 


HEX 
>» 


030E600C 
C0M10N 


CF26: 


00 


00 


FF 








CF29: 


00 






1594 

1594 

1594 

1595 * 128 X 

1596 

1596 


HEX 
<« 
<« 
32 
>» 
>» 


OOOOFFOO 

T128 
HT2 


CF2A: 


CA 






1596 
1596 


HEX 
<« 


CA 


CF2B: 


80 


96 




1596 
1596 


HEX 
>» 


8096 
SW2 


CF2D: 


4D 






1596 
1596 
1596 
1597 
1597 
1597 
1597 


HEX 
«< 
<« 
>» 

DO 

HEX 

ELSE 


4D 

X32 

LINEHZ160 
2F012029 


CF2E: 


27 


01 


20 








CF31 : 


24 






1597 
1597 


HEX 
FIN 


27012024 


CF32: 


03 


08 


60 








CF35: 


OC 






1597 
1597 


HEX 
>» 


030860OC 
COMMON 


CF36: 


00 


00 


FF 








CF39: 


00 






1597 
1597 
1597 

1598 * 

1599 SCLT8L 


HEX 
«< 
«< 


OOOOFFOO 


CF3A: 


05 






1600 


DF8 


SOS 


CF38: 


06 






1601 


0F8 


S06 


CF3C: 


OA 






1602 


0F8 


SOA 


CF3D: 


05 






1603 


DFB 


$05 


CF3E: 


05 






1604 


OFB 


$05 


CF3F: 


05 






1605 


OFB 


$05 


CF40: 


OA 






1606 


OFB 


$0A 



CF41: 


08 


1607 

1608 MULTBL 


DFB 


$08 


CF42: 


0! 


1609 


DFB 


$01 


CF43; 


02 


1610 


DFB 


$02 


CF44: 


06 


161 1 


DFB 


$06 


CF45: 


01 


1612 


DFB 


$01 


CF46: 


01 


1613 


DFB 


$01 


CF47: 


01 


1614 


DFB 


$01 


CF48: 


06 


1615 


DFB 


$06 


CF49: 


04 


1616 


DFB 


$04 
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— End assembly-- 
39U bytes 
Errors: 

Symbol table - alphabetical order: 



A1H 


=S3D 


AIL 


= $3C 


A2E 


= $C86B 


A2H 


= $3F 


A2L 


= $3E 


A4H 


= $43 


A4L 


= $42 


ADVANCE 


=$CBE5 


ADVNCE 


=SCC16 


APVTAB 


=$FC22 


ATCHR 


= $04 


ATDFLT 


= $80 


? ATHIO 


= $01 


? ATH11 


= $10 


? ATI. WO 


= $02 


? AT1NV1 


= $20 


ATLRG 


= $80 


ATRTBL 


= $C944 


ATSM L 


-$84 


ATTREC 


=$C083 


BADX 


=$CD78 


BADY 


=$CD6D 


BASCALC 


=$CD04 


BASEH 


=$0438 


BASEL 


=$03B8 


BASINP 


=$C9AD 


BASL 


-$28 


BASOUT 


=$CA15 


BELL 


=$CBD4 


BELLI 


=$CBD6 


BELL2 


= $CBD8 


BFORMT 


= $07 


BGETLN 


-$10 


M BtNIT 


-$C7EB 


BINV 


= $80 


BKEYBD 


= $20 


BLCCON 


= $40 


BOUT 


=$CA27 


BPOFF 


=$F8 


BS 


=$cccc 


BSTART 


= $C81A 


BSTART 1 


=$C912 


? BSTATE 


= $07 


BYTE 


=$05B8 


CO 


= $C0 


COOO 


=$CO00 


M C01 


-SC798 


A C03 


-SC7A3 


CAPSLK 


=$CB79 


CH 


= $24 


CHORZ 


=$0468 


CHRPUT 


= $CB6F 


CLEOL2 


= $CCB2 


CLEOLZ 


= $CCBE 


CLE0P1 


^SCBBE 


CL00P1 


= $C887 


CLREOL 


=$CCAC 


CLREOP 


=$CBB8 


M CLRX 


=$C737 


CLSCRN 


= $CBAA 


CLSK1P 


=$CCC4 


Ml) CNOO 


= SCO 00 


MD COMMON 


=$C000 


CONTROL 


=$CDF6 


CR 


=$CBF4 


CR1 


=$CBF9 


CRLF 


= $CC26 


CSL00P1 


-$C899 


CSRMOV 


=$CB10 


CSTART 


= $C8CF 


CSUW 


= $37 


CSWL 


-$36 


? CTLG 


=$CE68 


? CTLH 


=$CE6A 


? CTLI 


=$CE6C 


» CTLJ 


=$CE6E 


? CTLK 


= $CE70 


? CTLL 


=$CE72 


? CTLM 


=$CE74 


? CTLN 


=$CE76 


? CTLO 


=SCE78 


? CTLP 


= $CE7A 


? CTLO 


= $CE7C 


? CTLR 


=$CE7E 


? CTLS 


= $CE80 


? CTLT 


=$CE82 


CTLTBL 


= $CE5A 


» CTLU 


= $CE84 


? CTLV 


=$CE86 


? CTLW 


=$CE88 


? CTLX 


=$CE8A 


» CTLY 


=$CE8C 


? CTLZ 


-$CE8E 


? CTL20 


=$CEAA 


? CTLZ1 


=$CEAC 


* CTLZ2 


=$CEAE 


? CTLZ 3 


=$CEB0 


? CTL[ 


=$CE90 


? CTL\ 


= $CE92 


CTL] 


= $CE94 


? CTL~ 


= $CE96 


? CTL_ 


=$CE98 


CV 


= $25 


CVERT 


-$0538 


CVOK 


=$CE24 


DATA 


= $C081 


DISPO 


«$CC00 


DISP1 


-SCD00 


OOVTZ 


=$CD86 


? DSPTBL 


=$CE9A 


ENDUP 


=$CCD5 M ENTER 


=$C700 


M ENTR 


= $C73E 


ESC 


= $C9D2 


ESC2 


-SCDC3 


ESC0 


-$CE5A 


? ESCA 


=$CE5C 


? ESCB 


= $CE5R 


? ESCC 


=$CE60 


ESCD 


=$CE62 


? ESCE 


=$CE64 


? ESCF 


=$CE66 


ESCNEW 


=$CDB9 


ESCNOW 


-$CDC9 


ESCRD 


=$CDE2 


EXIT 


=$C809 


? FINIT 


=$C802 


FIXBUF 


=$CC80 


F1XCSR 


=$CE17 


FIXIT 


=$CC8E 


FIXWDTH 


=$CE50 


FLACS 


=$0738 


FLGCLR 


= $CBA3 


FLGSAV 


= $CBA6 


FLCSET 


=$CB98 


FLOOP1 


=$CC92 


FMT1 


=$CD47 


FORMAT 


=$CD34 


CETLN 


=$C9E0 


GETX 


=$CBE1 


GOTOX 


=$CD57 


GOTOY 


"SCD60 


GOXY 


-$CB80 


HEIGHT 


=$04F8 


HGTBL 


= $C92C 


HIATR 


=$CDA9 


HILITE 


=$CB92 


HOME 


= $CBAC 


MD HT1 


=$C000 


MD HT2 


=$C000 


IENTER 1 


=$C81C 


IEXIT 


= $C817 


IN 


=$0200 


INOONE 


= $CAF2 


M INEN'TR 


=$C73A J> 


? INFAXE 


=$C705 


M IN IT 


-$C717 


M INPUT 


=$C75D 


INVFLC 


= $32 !* 


10 


=$C758 


10RTS 


-$FFCB 


JSTADV 


= $CD83 


JVTAB 


= $CBD1 


KBD 


=$C000 


KBDSTRB 


=$C010 


KBDWAIT 


=$CA52 


KEYIN 


= $CB45 


KEYIN2 


= $CB4B 


KEYSTAT 


=$CA9C 


KSvm 


= $39 


KStfL 


= $38 


LEAD 


=$CD7B 


LEAD IK 


=$CB83 


? LEADTBL 


=$CEAA 


LF 


=$CC29 


LINEHZ 


= $3C 


LOATR 


=$CD98 


LOLETE 


=$CB9D 


LOOP 


=$C8BA 


LSTFIX 


=$CA5E 


MB132 


= SE0 


MB256 


= $D0 


MBANK 


=$80 


MBSVS 


= $C0 



-R38- 





MCPBITS 


= $FO 




MCREG 


=$C082 




MODE 


=$0478 




MODTBL 


= $C924 


M 


MOVE 


= $C763 


M 


MOV'EC 2M 


1 -$C7 78 


M 


MOVELOOP = $C780 


M 


MOVERET 


=$C 7AC 


M 


MOVESTRT-SC7 7E 




MPADDR 


-$10 




MPBANK 


= $80 




M PC LOCK 


= $20 




MPVIDEO 


-$40 




MSLOT 


= $07F8 




MULTBL 


=$CF42 




NO 


=$06F8 




N512 


=$CC4D 




NCOMMA 


=$CE4 7 




NEWFMT 


=$C86F 




NEWFMT2 


=$C8DA 




NFSKIP 


=$C90E 




NOCSR 


= $CA3A 




NORJ'IOUI 


' =$CA8B 




NOSH I FT 


=$CAFO 




NOT@ 


=$CAE6 




NOTCR 


-$C9F5 




NOTK 


=$CAB9 




NOTLWR 


=$CAA9 




NOTPICK 


=$C9FC 




NT512 


=$CD0F 




NTEOL 


= $CE45 




NTGETLN 


-SC9FF 




NTQTE 


= SCC9B 




NTSHFT 


=$CACA 


M 


NXTA1 


=$C78A 




NXT1N 


"• SCC A 6 




OLDCHAR 


=$0678 


M 


OUTENTR 


=$C707 




0UTPT1 


=$CE06 


M 


OUTPUT 


= $C7FA 




PAGSEL 


= $C978 




PINIT 


=$C800 




POFF 


=$06B8 




PRO 


=$CD38 




PREAD 


=$CB42 




PREADV 


=$CBEB 




PROMPT 


= $33 




PSTART 


= $C818 




PWDTBL 


=$C93C 




PWDTH 


= $05F8 




PWRITE 


■ SCB04 




PWRlTEl 


= $CB07 




RAW 


=$CB86 




RAWVID 


-$CD8B 




RDKEY 


-SCB59 




RDSCRN 


SC94C 




RDSKIP 


= $C850 


M 


READ 


-SC71D 




REGSEL 


= $C080 




RESTART 


=$C83C 




RNDH 


= $4F 




RjNDL 


=$4E 




RSKIP1 


= $C962 




RTSO 


= $CB58 




RTS1 


=$CD33 




RTS2 


=$C£4F 




KTS3 


=$CDED 




RTS4 


-SCE05 




RTS5 


=$CB7F 




RTS6 


=$CB41 




RTS8 


= $CBF3 


1 


RTS9 


=$CAFA 




SAVOLD 


=$CA04 




SCLTBL 


=$CF3A 




SETATR 


=$CB8C 




SETCH 


= $CA6D 




SETKBD 


-SFF89 




SETUP 


=$C82 7 




SETUP! 


=$C831 




SETVID 


-$FE93 




SHUTUP 


=$CBIE 




SPKR 


-SC03O 




SSKIP 


= $CB27 


1 


STACK 


$0100 




START 


=$0638 




STATE 


-$CF,B2 


M 


STATUS 


=$C72A 




STOADV 


=$CBFF 


MD 


SW1 


=$C000 


MD 


SW2 


=$C 000 




SWDTBL 


=$C934 




SWDTH 


=$0578 


MD 


T128 


=$C000 


MD 


T132 


=$C000 


MD 


T160 


=$C000 


MC 


i T80 


=$C000 


MD 


T96 


=$C000 




TABLE 


= $CEBA 




TEMPX 


=$0778 




TINIT 


=$C8D8 




UP 


=$CCDE 




VIDEO 


=$CB89 




VIDOUT 


=$CDEE 


? 


VIDWAIT 


=$FB78 




VSK1P 


=$CA7F 




VTAB 


=$CCE6 




VTABZ 


= $CCE9 




VTLOOP 


=$CCFB 




WNDWDTH 


-$21 


M 


WRITE 


= $C724 




WSKIP 


=$CB75 


MD 


X24 


=$cooo 


MD 


X24I 


=$C000 


MD 


X32 


= $C000 


MD 


X48 


=$C000 


M 


XFER 


=$C 7 BO 


M 


XFERA2P 
XSAVE 


= $C 7CD 
= $35 


M 


XFERC2M 
ZERO 


=$C 7C 5 

= $CAEE 


M 


XFERSZP 


= $C7DC 




XLTBL 


= SCE55 


Symbol table - numerical order 
















? 


ATHIO 


=$01 


i 


AT1NV0 


=$02 




ATCHR 


=$04 


? 


BSTATE 


= $07 




BFORMT 


=$07 




BCETLN 


= $10 




MPADDR 


= $10 


? 


ATHI1 


= $10 




BKEYBD 


=$20 




MPCLOCK 


= $20 


■> 


AT1NV1 


=$20 




WNDWDTH 


=$21 




CH 


= $24 




cv 


= $25 




BASL 


=$28 




1NVFLG 


= $32 




PROMPT 


=$33 




XSAVE 


=$35 




CSWL 


«$36 




CSWH 


= $37 




KSWL 


= $38 




KSWH 


= $39 




LINE HZ 


=$3C 




AIL 


= $3C 




AlH 


= $3D 




A2L 


=?3E 




A2H 


= $3F 




BLCCON 


= $40 




MPVIDEO 


«$40 




A4L 


= $42 




A4H 


= $43 




RNDL 


= $4£ 




RNDH 


= $4F 




BINV 


-$80 




MPBANK 


= $80 




MBANK 


= $80 




ATDFLT 


=$80 




ATLRG 


-$80 




ATSML 


=$84 




CO 


= $C0 




MBSVS 


= $C0 




MB256 


=$D0 




MB132 


=$E0 




MCPKITS 


= $F0 




BPOFF 


= $F8 


? 


STACK 


=$0100 




IN 


=$0200 




BASEL 


=$03B8 




BASEH 


=$0438 




MODE 


=$0478 




CHORZ 


=$04B8 




HEIGHT 


=$04F8 




CVERT 


=$0538 




SWDTH 


=$0578 




BYTE 


=$05B8 




PWDTH 


-S05F8 




START 


=$0638 




OLDCHAR 


=$0678 




POFF 


=$06B8 




NO 


-$06F8 




FLAGS 


=$0738 




TEMPX 


=$0778 




MSLOT 


=$07F8 




COOO 


=$C0O0 




KBD 


-SC0OO 


MD 


I1T1 


=SC000 


MD 


HT2 


=$C000 


MD 


SW1 


=$cooo 


KD 


SW2 


= $COOO 


MD 


T80 


=$C000 


MD 


T96 


-$C000 


MD 


T128 


=$cooo 


MD 


T132 


=$COOO 


MD 


T160 


= $C0O0 


MD 


X24 


-SCOOO 


MD 


X24I 


= scooo 


MD 


X32 


=$C000 


MD 


x48 


=$cooo 


MD 


COMMON 


=$cooo 


MD 


CNOO 


=$cooo 




KBDSTRB 


=$C010 




SPKR 


= $C030 




REGSEL 


=$C080 




DATA 


=$C081 




MCREG 


=$C082 




ATTREC 


= $C083 


M 


ENTER 


= $C700 


M? 


INFAKE 


= $C705 



M OUTENTR =$C70 7 


M INIT 


=$C717 


M READ 


= $C7lD 


M WRITE 


«$C724 


M STATUS 


= $C72A 


M CLRX 


=$C737 


M INENTR 


= $C73A 


M ENTR 


= Sf!73P 


M 10 


=$C758 


M INPUT 


=$C75D 


M MOVE 


=$C763 


M MOVECZM =SC 7 78 


M M0VESTRT=5>L//E 


M MOVELOOP=$C780 


M NXTA1 


= $C78A 


M CO] 


= SC7Qft 


M C03 


= $C7A3 


M MOVERET =$C7AC 


M XFER 


=$C7B0 


M XFERCZM =Sr7(?S 


M XFERAZP =$C7CD 


M XFERSZP =$C7DC 


M BINIT 


= $C7EB 


M OUTPUT 


= $C7FA 


PINIT 


=$C800 


? FINIT 


=$C802 


EXIT 


= $C809 


IEXIT 


= $C817 


PSTART 


=$C818 


BSTART 


-$C81A 


I ENTER 


= $C8lC 


SETUP 


3 $C827 


SETUP1 


=$C831 


RESTART =$C83C 


RDSKIP 


=$C850 


A2E 


=$C86B 
=$C8BA 


NEWFMT 


= $C86F 


CL00P1 


=$C887 


CSLOOP 


=$C899 


LOOP 


CSTART 


=$C8CF 


TINIT 


=$C8D8 


NEWFMT2 


= $C8DA 


NFSKIP 


= $C90E 


BSTART] 


=$C912 


MODTBL 


= $C924 


HGTBL 


=$C92C 


SWDTBL 


=$C934 


PWDTBL 
PAGSEL 


= $C93C 
=$C978 


ATRTBL 
BAS1NP 


=$C944 
-$C9AD 


RDSCRN 
ESC 


=$C94C 
= $C902 


RSKIPl 
GETLN 


-$C962 
^$C9E0 


NOTCR 


= $C9F5 


NOTPICK 


=$C9FC 


NTCETLN 


= $C9FF 


SAVOLD 


=$CA04 


BASOUT 


=$CA15 


BOUT 


= $CA2 7 


NOCSR 


= $CA3A 


KBDWAI1 


= $CA52 


LSTFIX 


= $CA5E 


SETCH 


= $CA6D 


VSKIP 


= $CA7F 


NORMOUT 


= $CA8B 


KEYSTAT 


= $CA9C 


NOTLWR 


-$CAA9 


NOTK 


= $CAB9 


NTSHFT 


=$CACA 


NOT@ 


= $CAE6 


ZERO 


=$CAEE 


NOSHIFT 


=$CAFO 


INDONE 


=$CAF2 


? RTS9 


=$CAFA 


PWRITE 


= $CB04 


PWRITE l 


-$CB07 


CSRMOV 


-$CB10 


SHUTUP 


*$CB1E 


SSKIP 


= $CB2 7 


RTS6 


=$CB4I 


PR£AD 


=$CB42 


KEYIN 


-$CB45 


KEYIN2 


-$CB4B 


RTSO 


■$CB58 


RDKEY 


■$CB59 


CHRPUT 


-$CB6F 


WSKIP 


-$CB75 


CAPSLK 


-$CB79 


RTS5 


-$CB7F 


GOXY 


*$CB80 


LEADIN 


=$CB83 


RAW 


= $CB86 


VIDEO 


-$CB89 


SETATR 


= $CB8C 


HILITE 


=$CB92 


FLCSET 


=$CB98 


LOLITE 


-$CB90 


FLGCLR 


-$CBA3 


FLGSAV 


=$CBA6 


CLSCRN 


=$CBAA 


HOME 


-$CBAC 
-$CBD4 
■$CBE5 


CLREOP 


=$CBB8 


CLE0P1 


= $CBBE 


JVTAB 


-$CBDl 


BELL 


BELLI 


=$CBD6 


BELL2 


= $CBD8 


GETX 


*$CBEl 


ADVANCE 


PREADV 


$CBEB 


RTS8 


=$CBF3 


CR 


=$CBF4 


CR1 


=$CBF9 


STOADV 


-$CBFF 


DISPO 


=$CCOO 


ADVNCE 


= $CC 16 


CRLF 


-$CC26 


LF 


=$CC29 


N512 


=$CC4D 


FIXBUF 


=$CC80 


FIXIT 


=$CC 8E 


FL00P1 


=$CC92 


NTQTE 


-$CC9B 


NXTIN 


=$CCA6 


CLREOL 


=$CCAC 


CLE0L2 


=$CCB2 


CLEOLZ 


-SCCBE 


CLSKTP 


=$CCCb 


BS 


=$CCCC 


ENDUP 


=$CCD5 


UP 


=$CCDE 


VTAB 


=$CCE6 


VTABZ 


= $CCE9 


VTLOOP 


=$CCFB 


DISP1 


= $CDOO 


BASCALC 


=$CD04 


NT512 


=$CD0F 


RTS1 


=$CD33 


FORMAT 


=$CD34 


PRO 


=$CD38 


FMT1 


=$CD47 


GOTOX 


= $CD57 


COTOY 


=$CD60 


BADY 


= $CD6D 


BADX 


-$CD78 


LEAD 


=$CD7B 


JSTADV 


=$CD83 


DOVTZ 


=$CD86 


RAWVID 


=$CD8B 


LOATR 


=$CD98 


HIATR 


= $CDA9 


ESCNEW 


= $CDB9 


ESC2 


=$CDC3 


? ESCNOW 


= $CDC9 


ESCRD 


=$CDE2 


RTS3 


=$CDED 


VIDOUT 


=$CDEE 


CONTROL 


=$CDF6 


RTS4 


=$CE05 


0UTPT1 


=$CE06 


FIXCSR 


= $CE17 


CVOK 


=$CE24 


NTEOL 


=$CE45 


NCOMMA 


=$CE47 


RTS2 


=$CE4F 


FIXWDTH 
? ESCA 


=$CE50 
=$CE5C 


XLTBL 
? ESCB 


=$CE55 
=$CE5E 


CTLTBL 
7 ESCC 


=$CE5A 

=$CE60 


? ESC@ 

? ESCD 


= $CE5A 
=$CE62 


? ESCE 


=$CE64 


? ESCF 


=$CE66 


? CTLC 


=$CE68 


? CTLH 


=$CE6A 


? CTLI 


=$CE6C 


? CTLJ 


-$CE6E 


> CTLK 


=$CE70 


7 CTLL 


= $CE72 


? CTLM 


=$CE74 


? CTLN 


=$CE76 


> CTLO 


=$CE78 


? CTLP 


=$CE 7A 


? CTLQ 


= $CE7C 


? CTLR 


= $CE7E 


> CTLS 


=$CE80 


' CTLT 


=$CE82 


? CTLU 


=$CE84 


? CTLV 


=$CE86 


' CTLW 


=$CE88 


CTLX 


=$CE8A 


? CTLY 
? CTL] 


=$CE8C 


? CTLZ 


=$CE8E 


CTL[ 


=$CE90 


CTL\ 


=$CE92 


=$CE94 


? CTL~ 


= $CE96 


CTL_ 


=»$CE98 


DSPTBL 


=$CE9A 


7 LEADTBL 


=$CEAA 


? CTLZO 


=$CEAA 1 


CTLZI 


=$CEAC \ 


CTLZ2 


=$CEAE 


J CTLZ3 


= $CEBO 


STATE 


-$CEB2 


TABLE 


-$CEBA 


SCLTBL 


-$CF3A 


MULTBL 


=$CF42 


? VIDWAIT 


«$FB78 


A P VTAB 


=$FC22 


SETKBD 


=$FE89 


SETVID 


=$FE93 


IORTS 


=$FFCB 











Section F.2 ASSEMBLY CROSS REFERENCE FOR UltraTerm 



ASSEMBLY CROSS REFERENCE FOR ULTRATERM 



DEF 

31 

30 

525 

33 

32 

35 

34 

1110 

U39 

44 

109 

106 

111 

108 

110 

107 

113 

662 

114 

104 

1354 

1349 

1285 

63 

62 

723 

22 

779 

1085 

1087 

1089 

75 

76 

397 

79 

77 

78 

789 

71 

1248 

471 

613 

70 

66 

13 

14 

340 

347 

983 

20 

64 



LABEL 
A1H 
A 1L 
A2E 
A2H 
A2L 
A4H 
A4L 

ADVANCE 
ADVNCE 
APVTAB 
ATCHR 
ATDFLT 
ATH L 
ATHL1 
ATINV0 
ATLNV1 
ATLRC 
ATRTBL 
ATSML 
ATTREC 
BADX 
BADY 
BASCALC 
BASEH 
BASEL 
BASINP 
BASL 
BASOUT 
BELL 
BELLI 
BELL2 
BF0R>IT 
BCF.TLN 
BINIT 
BLNV 
BKEYBD 
BLCCON 
BOUT 
BPOFF 
BS 

BSTART 
BSTART1 
BSTATE 
BYTE 
CO 
COOO 
COl 
C03 
CAPSLK 
CH 
CHORZ 



REFERENCES 
335 339 



327 

515 

336 

334 

331 

328 

1505 

1112 

834 

114 

113 



666 

607 

663 

608 

1352 

1347 

1169 

532 

531 

301 

276 

409 

1516 

1094 

1091 

563 

748 

293 

1029 

502 

869 

784 

489 

1506 

300 

582 



333 

522 



329 
1537 



667 669 670 

1384 

664 665 668 

1397 



700 942 1178 1297 1311 

697 937 1173 1303 1308 1309 



593 1157 1273 1327 1331 1381 
781 782 798 



103 7 
853 858 859 



1517 
408 



975 CHRPUT 



790 800 902 915 1122 1141 1427 1444 

14 62 63 64 65 66 67 68 73 

122 217 432 438 507 720 910 927 

338 

345 

734 1211 1426 

823 1468 1475 1483 

533 676 816 924 1115 1126 H32 1140 1143 1220 1249 

1251 1256 1257 1353 1469 1474 1485 1487 

1137 1226 



ASSEMBLY CROSS REFERENCE FOR ULTRATERM 



DEF LABEL 


REFERENCES 


1223 CLEOL2 


1237 




1231 CLEOLZ 


1073 


1186 1221 


1066 CLE0P1 


1075 




541 CL00P1 


557 




1219 CLREOL 


1064 


1196 1509 1538 


1063 CLREOP 


1510 


1520 


269 CLRX 


255 


264 267 


1052 CLSCRN 


620 


1504 1521 


1235 CLSKTP 


1229 




216 CNOO 


440 


441 442 443 444 


2 1 2 COMMON 


179 


189 199 209 


1^37 CONTROL 


1367 


1410 1420 1458 


1121 CR 


1522 




1124 CR1 


1057 


1148 


1147 CRLF 


1117 


1123 1478 


552 CSL00P1 


555 




920 CSRMOV 


795 


964 


581 CSTART 


479 




2 7 CSWH 


403 




26 CSWL 


402 




1516 CTLC 






1517 CTLH 






1518 CTLI 






1519 CTLJ 






1520 CTLK 






1521 CTLL 






1522 CTLM 






1523 CTLN 






152 4 CTLO 






1525 CTLP 






1526 CTLO 






152 7 CTLR 






1528 CTLS 






1529 CTLT 






1503 CTLT8L 


1440 


1442 


1530 CTLU 






1531 CTLV 






1532 CTLW 






1533 CTLX 






1534 CTLY 






1535 CTL2 






1557 CTLZO 






1558 CTLZ1 






1559 CTL22 






1560 CTLZ3 






1536 CTL[ 






1537 CTLN 






1538 CTL] 






1539 CTL" 






1540 CTL 






21 CV 


828 


841 1462 1480 


65 CVERT 


534 


830 840 1058 1065 




1348 


1463 1465 1479 



1150 1151 1154 1262 1264 1269 



ASSEMBLY CROSS REFERENCE FOR ULTRATERM 



DEF 


LABEL 


REFERENCES 




1467 


CVOK 


1464 






90 


DATA 


573 


938 944 


971 1175 11: 


118 


DISPO 


678 


977 




119 


DLSP1 


680 


980 




1365 


D0VT2 


1362 






1546 


DSPTBL 








1254 


ENDUP 


1250 






223 


ENTER 


290 


291 




279 


ENTR 


225 


232 




740 


ESC 


752 






1407 


ESC2 


1405 


1422 




1504 


ESC(3 








1505 


ESCA 








1506 


ESCB 








1507 


ESCC 








1508 


ESCD 








1509 


ESCE 








1510 


ESCF 








1402 


ESCNEW 


74i 






1411 


ESC NOW 








1424 


ESCRD 


1403 


1421 




4 58 


EXIT 


838 


919 




454 


FINIT 








11 B9 


FIXBUF 


756 






1461 


F1XCSR 


725 


791 




1197 


FIXIT 


1192 


1194 




1492 


FIXWDTH 


796 


835 




73 


FLAGS 


527 


562 583 


592 780 854 






1039 


1041 1156 1272 1380 


1038 


FLGCLR 


799 


1328 




1040 


FLGSAV 


1032 






1030 


FLCSET 


749 


1332 




1200 


FLOOPl 


1215 






1325 


FMT1 


1317 






1315 


FORMAT 


1406 


1552 




74 7 


CETLN 


727 


731 733 


739 744 


1095 


GETX 


1238 






1335 


COTOX 


1548 






1342 


GO TOY 


1549 






1000 


GOXY 


1539 






52 


HEIGHT 


599 


615 1068 


1152 1181 


632 


HGTBL 


598 






1389 


HIATR 


1554 






1026 


HILITE 


1524 


1560 




1055 


HOME 


579 


1534 




126 


HT1 


143 


149 




130 


HT2 


155 


161 167 




475 


IENTERl 


457 






464 


IEXIT 


498 






42 


IN 


732 


735 738 


1201 1212 


899 


INDONE 


861 


880 882 


892 894 


275 


INENTR 


398 






226 


INFAKE 









855 857 868 870 876 1031 



1346 



— F.43— 



ASSEMBLY CROSS REFERENCE FOR ULTRATERM 



DEF LABEL 


REFERENCES 




897 NOSHIFT 


884 






890 NOT@ 


888 






758 NOTCR 


754 






865 NOTK 


863 






856 NOTLWR 


852 






762 NOTPICK 


746 


760 




1292 NT512 


1290 






1482 NTEOL 


1477 






765 NTGETLN 


736 






1206 NTQTE 


1204 






874 NTSHFT 


867 






332 NXTA1 


330 






1213 NXT1N 


1210 






55 OLDCHAR 


729 


737 


769 785 


229 OUTENTR 


401 






1451 0UTPT1 


792 


918 




407 OUTPUT 


297 






693 PACSEL 


677 


U33 


1232 


451 P1N1T 


248 


404 




68 POFF 


484 


488 


497 1014 14 


1318 PRO 


1530 


1558 




949 PREAD 


253 


508 




1114 PREADV 


1111 


1131 




24 PROMPT 


1190 






467 PSTART 


917 


950 




652 PWDTBL 


602 






54 PWDTH 


280 


287 


603 817 935 


914 PWR 1 TE 


258 






916 PWRITE1 


721 






1006 RAW 


1527 






1369 RAWV1D 


1551 






963 RDKEY 


750 


766 


1425 


672 RDSCRN 


761 






510 RDSK1P 


505 






252 READ 


240 






89 REGSEL 


571 


710 


923 940 969 


494 RESTART 


1557 






37 RNDH 


954 






36 RNDL 


952 






681 RSKLP1 


679 






961 RTSO 


456 


1518 


1525 1526 


1312 RTS1 


1263 


1306 


1310 


1488 RTS2 


1486 






1429 RTS3 


1413 


1415 


1417 


1446 RTS4 


1436 






987 RTS5 


985 






945 RTS6 


936 






1118 RTS8 


1142 


1145 




906 RTS9 








768 SAVOLD 


764 






1599 SCLTBL 


1159 






1012 SETATR 


1532 






822 SETCH 


777 


819 





1455 



1116 1144 1255 1304 1351 1476 



1528 1529 1533 1536 



ASSEMBLY CROSS REFERENCE FOR ULTRATERM 



DBF 

24 7 

299 

23 

295 

47 

1363 

1076 

83 

84 

808 

951 

955 

849 

29 

28 

1357 

1003 

1556 

1149 

12 

H78 

1034 

570 

814 

100 

99 

!02 

101 

93 

91 

51 

622 

305 

319 

326 

352 

323 

97 

94 

96 

95 

58 

1608 

56 



LABEL 
INIT 
INPUT 
INVFLC 
10 

IORTS 
JSTADV 
JVTAB 
KBD 

KBDSTRB 
KBDWAIT 
KFYIN 
KEYIN2 
KEYSTAT 
KSWH 
KSWL 
LEAD 
LEAD IN 
LEADTBL 
LF 

LINEHZ 
LOATR 
LOLITE 
LOOP 
LSTFLX 
MB132 
MB256 
H BANK 
MBSVS 
MCPHLTS 
MCREC 
MODE 

MODTBL 
MOVE 

M0VEC2M 

MOVELOOP 

MOVERET 

MOVESTRT 

M PA DDR 

MPBANK 

MPCLOCK 

MPVIDEO 

MS LOT 

MULTBL 

NO 



REFERENCES 

239 

296 

585 1028 

292 

224 

1371 

1059 



1 166 N512 

14 84 N COMMA 

528 NEWFMT 

589 NEWFMT2 

610 NFSKIP 

797 NOCSR 

837 NORMOUT 



1434 
1069 



265 803 809 956 

807 813 871 960 

810 

957 959 965 

953 

268 958 

400 793 

399 

1550 

1535 



1507 
173 
1553 
1523 

577 

802 

625 

546 

460 

623 

701 

462 

459 

825 

595 

244 

314 

341 

350 

317 

99 

99 

100 

99 

477 

1275 

461 

1396 

1164 

14 70 

485 

529 

606 

794 

826 



1519 
183 193 203 



1559 



804 806 812 

629 630 

624 625 626 627 628 629 630 

684 

742 824 1163 1289 1321 

548 561 597 687 704 

463 545 560 596 609 673 675 683 685 702 743 

1162 1286 1322 1323 



100 101 102 



100 101 
558 578 611 689 775 839 1096 1138 1216 1230 



476 547 559 591 686 703 708 921 968 1170 1320 



1472 
1333 



-F.45- 



ASSEMBLY CROSS REFERENCE FOR ULTRATERM 



DEF 


LABEL 


REFERENCES 




45 


SETKBD 


833 






481 


SETUP 


478 






487 


SETUP1 


482 






46 


SETVID 


832 






928 


SHUTUP 


932 






85 


SPKR 


1092 






934 


SSKIP 


925 






41 


STACK 








67 


STAKT 


535 


1161 


1167 


1563 


STATE 


1454 






262 


STATUS 


242 






1129 


STOADV 


1364 






134 


SW1 


145 


151 




138 


SW2 


157 


163 


69 


642 


SWDTBL 


600 






53 


SWDTH 


601 


617 


236 


154 


T128 


1596 






160 


T132 


1593 






166 


T160 


1581 






142 


T80 


1575 


1584 


158 


148 


T96 


1578 






1573 


TABLE 


572 






57 


TEMPX 


1271 


1277 


128 


586 


TINLT 


616 


618 


)19 


1261 


UP 


1508 


1540 




1009 


VIDEO 


1531 






1432 


VIDOUT 


1373 


1375 


154 


43 


VIDWAIT 








831 


VSKLP 


829 






1268 


VTAB 


1060 


1077 


118 


1270 


VTABZ 


1071 


1184 




1280 


VTLOOP 


1283 






19 


WNDWDTH 


605 


1494 




257 


WRITE 


241 






979 


WSKIP 


976 






* 


X 


774 






172 


X24 


1576 


1579 


158 


182 


X24I 


1585 


1594 




192 


X32 


1588 


1597 




202 


X48 


1591 






360 


XFER 


245 






377 


XFERAZP 


371 






372 


XFERC2M 


367 






386 


XFERSZP 


370 


375 




1496 


XLTBL 


1419 






25 


XSAVE 


281 


726 


130 


* 


Y 


553 


1419 


1454 


895 


ZERO 


886 







1339 1350 1386 1395 



1355 1466 















Section F.3 SCREEN DRIVERS 


2 


* This I 


isting has been provided to assist programmers in 




3 


* develo 


ping 


software for the Ultracerrn. If further information 




4 


* is nee 


ded, 


consult che 


Ultraterm software guidelines document. 




5 


* 










6 


* These 


screen drivers consist of the following routines 




? 


A 










8 


* INIT 




Initializes the Ultraterm in a given format 


h*l 


9 


* G0T0XY 




Calculates 


an X Y position on the screen 


10 


* SCROLL 




Scrolls the screen up by one line 




1 1 


* STtADV 




Stores a character on the screen and advances 




12 


* CURSOR 




Puts the cursor on che screen 


m* *M 


13 


* CSROFF 




Removes the cursor from che screen 




14 


* 








|||M 


15 


* The Ultraterm has 8 different screen formats; che cable below, 




lb 
17 


* lists 

A 


these 


formats and their associated number 


F«^ 


18 


* Format 


(1 


Descript ion 




19 


* 




80 x 24 


non- inter laced 


m *^ H 


20 


* 1 




96 x 24 


non- Inc er laced 




21 


* 2 




160 x 24 


non- interlaced 




22 


* 3 




80 x 24 


interlaced 




23 


* 4 




80 x 32 


inter laced 




24 


* 5 




80 x 48 


interlaced 




25 


* 6 




160 x 24 


interlaced (used for 132 x 24) 




26 


* 7 




128 x 32 


interlaced 




27 


* 










28 


* 










29 


CH 


EQU 


S01 


; NOTE: CH AND CV SHOULD BE MAINTAINED 




30 


cv 


EOU 


S02 


BY THE OR IV INC PRtGRAM 




31 


PACE 


" 


S03 






32 


NO 


EOU 


$04 






33 


MSLOT 


EQU 


N»+$01 






3^ 


MODEMASK 


KQU 


S06 






35 


FORMAT 


EQU 


S07 






36 


YSAVE 


EQU 


$08 






37 


A 










38 


MtDE 


EOU 


$478 






39 


A 










40 


START 


EQU 


S6F8-SC0 






41 


FLAGS 


EOU 


S7F8-SC0 






42 


* 










43 


DEVO 


EQU 


SC080 






44 


DEVI 


EOU 


SC081 






45 


DEV2 


EQU 


SC082 

— F.47- 















47 










48 










49 










50 










51 


8000: 


84 


07 




52 


8002: 


09 


CO 




53 


8004: 


AA 






54 


8005: 


86 


05 




55 


8007: 


OA 






56 


8008: 


OA 






57 


8009: 


OA 






58 


800A: 


OA 






59 


QOOB: 


AO 






60 


80OC: 


84 


04 




61 


800E: 


AD 


FF 


CF 


62 


8011: 


Bl 


04 




63 


8013: 


A5 


07 




64 


8015: 


9D 


38 


07 


65 


8018: 


20 


02 


C8 


66 


801B: 


AD 


78 


04 


67 


801fc: : 


09 


10 




68 


8020: 


85 


06 




69 


8022: 


60 






70 
71 

72 
73 
74 
75 
76 


8023: 


A6 


05 




77 


8025: 


18 






78 


8026: 


A4 


07 




79 


8028: 


B9 


BF 


80 


80 


802B: 


7D 


38 


06 


81 


802E: 


9D 


38 


06 


82 


8031: 


20 


B2 


80 


83 


8034: 


48 






84 


8035: 


A9 


OC 




85 


8037: 


A4 


04 




86 


8039: 


99 


80 


CO 


87 


803C: 


A5 


03 




88 


803E: 


29 


OF 




89 


8040: 


99 


81 


CO 


90 


8043: 


A9 


OD 




91 


8045: 


99 


80 


CO 


92 


8048: 


68 






93 


8049: 


99 


81 


CO 


94 



* INITIALIZATION 

* ENTER WITH SLOT IN A AND FORMAT IN Y 

* 
INIT 



; SAVE FORMAT 
; MAKE SCN 



MAKE $N0 



STY FORMAT 

ORA //SCO 

TAX 

STX MSLOT 

ASL 

ASL 

ASL 

ASL 

TAY 

STY NO 

LDA SCFFF 

LDA (NO),Y 

LDA FORMAT 

STA FLAGS,X 

JSR $C802 

LDA MODE 

ORA 0S1O 

STA MODEMASK 

RTS 



* SCROLL ROUTINE 
* 

* SCROLLS SCREEN AND RECALCULATES START 
* 

SCROLL 



BANK OFF ROMS 
SELECT CNOO 
INIT WITH FORMAT 



; CREATE MODE MASK 



LDX MSLOT 

CLC 

LDY FORMAT 

LDA MTBL.Y 

ADC START, X 

STA START, X 

JSR MULTIPLY 

PHA 

LDA //$0C 

LDY NO 

STA DEVO.Y 

LDA PAGE 

AND 0SOF 

STA DEV 1 , Y 

LDA 0$OD 

STA DEVO,Y 

PLA 

STA DEVI,Y 



; GET VARIABLE INDEX 



ADD SCREEN WIDTH / $10 
TO START, X 



; MULTIPLY BY $10 

; SELECT START HIGH REGISTER 

; SET START HIGH 

; SELECT START LOW REGISTER 

; SET START LOW 



804C: A 6 05 
804E: A 4 07 



8050: 

8053: 
8056: 
8056: 

8057 
8059 
805A 

805C: 
805F: 
8062: 
8063: 
8065: 
8066: 
8068: 
806A: 



B9 BF 80 
A8 

A9 00 
18 

65 02 
88 
DO FB 

7D 38 06 
20 B2 80 
18 

65 01 
AA 

90 OD 
£6 03 
4C 75 80 



806D: 9D 00 CC 

8070: E8 

8071: DO 11 

8073: E6 03 



8075: 
8077: 
8079: 
807B: 
807D: 
80 7F: 
8082: 



84 08 
A5 03 
29 OF 
05 06 
A4 04 
99 82 CO 
A4 08 



8084: 60 



96 

97 

98 

99 

100 

101 

102 

103 

104 

105 

106 

107 

108 

109 

110 

1 1 1 

112 

113 

114 

115 

116 

117 

118 

1 19 

120 

121 

122 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 



* COTO X, Y 

* CREATES NEW PAGE AND 
* 

GOTOXY 

LDX MSLOT 

LDY FORMAT 

LDA MT8L.Y 

TAY 

LDA //$00 

CLC 
MLOOP 

ADC CV 

DEY 

8NE MLOOP 

ADC START, X 

JSR MULTIPLY 
CLC 

ADC CH 
TAX 

BCC PACSEL 

LNC PACE 

JMP PACSEL 

* STORE AND ADVANCE 



X WITH CH, CV, AND START, X 
; GET VARIABLE INDEX 



MULTIPLY BY WIDTH / $10 



ADD START OFFSET 
MULTIPLY BY $10 



ADD CH OFFSET 
SELECT SCREEN PACE 



* STORE CHARACTER LN A 

* INCREMENT X AND PACE 



AT CURRENT POSITION 



STA $CCOO,X 
I NX 

BNE EXIT 

LNC PACE 

STY YSAVE 

LDA PACE 

AjND f/$OF 

ORA MODEMASK 

LOY NO 

STA DEV2.Y 

LDY YSAVE 

RTS 



PUT CHARACTER IN A ON SCREEN 
ADVANCE SCREEN POSITION 



SELECT NEXT PAGE 



; SAVE Y 

; PUT PAGE MUM INTO MCP 
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142 


* 


MOVE 


THE CURSOR AND TURN 


IT ON 










143 


* 


















144 


CURSOR 








8085: 


84 


08 




145 






STY 


YSAVE ; 


SAVE Y 


8087: 


A4 


04 




146 






LDY 


NO 




8089: 


A9 


OE 




147 






LDA 


>/$0E ; 


SELECT CURSOR HIGH REGISTER 


808B: 


99 


80 


CO 


148 






STA 


DEV0,Y 




808E: 


A5 


03 




149 






LDA 


PACE ; 


SAVE CURSOR HIGH 


8090: 


29 


IF 




150 






AND 


0$1F 




8092: 


99 


81 


CO 


151 






STA 


DEV1.Y 




8095: 


A9 


OF 




152 






LDA 


//$0F ; 


SELECT CURSOR LOW REGISTER 


8097: 


99 


80 


CO 


153 






STA 


DEVO,Y 




809A: 


8A 






154 






TXA 




SAVE CURSOR LOW 


809B: 


99 


81 


CO 


155 






STA 


DRV1,Y 




809E: 


A4 


08 




156 






LDY 


YSAVE ; 


RECOVER Y 


80A0: 


60 






157 
158 
159 


* 




RTS 














160 


* 


TURN 


CURSOR 


OFF 












161 


* 


















162 


* 


















163 


CSROFF 








80A1: 


84 


08 




164 






STY 


YSAVE ; 


SAVE Y 


80A3: 


A4 


04 




165 






LDY 


NO 




80A5: 


A9 


OE 




166 






LDA 


//$0E ; 


SELECT CURSOR HIGH REGISTER 


80A7: 


99 


80 


CO 


167 






STA 


DEVO,Y 




80AA: 


A9 


FF 




168 






LDA 


0SFF ; 


PUT CURSOR OFF OF SCREEN 


80AC: 


99 


81 


CO 


169 






STA 


DEV 1,Y 




80AF: 


A4 


08 




1 70 






LDY 


YSAVE ; 


RECOVER Y 


80B1: 


60 






171 
172 
173 


* 
* 




RTS 














174 


MULTIPLY 




MULTLPLY BY $10 


80B2: 


48 






175 






PHA 






80B3: 


6A 






176 






ROR 






80B4: 


4A 






177 






LSR 






80B5: 


4A 






178 






LSR 






80B6: 


4A 






179 






LSR 






80B7: 


85 


03 




180 






STA 


PACE ; 


SAVE PAGE NUMBER 


80B9: 


68 






181 






PLA 






80BA: 


OA 






182 






ASL 






80BB: 


OA 






183 






ASL 






80BC: 


OA 






184 






ASL 






80BO: 


OA 






185 






ASL 






80BE: 


60 






186 
187 


* 




RTS 














188 


MTIL 








80BF: 


05 






189 






DFB 


80/ $10 




80C0: 


06 






190 






DFB 


96/S10 




80CI : 


OA 






191 






DFB 


160/$10 




80C2: 


05 






192 






DFB 


80/S10 




80C3: 


05 






193 






DFB 


80/510 




80C4: 


05 






194 






UFB 


80/ $10 




80C5: 


OA 






195 






DFB 


160/510 




80C6: 


08 






196 






DFB 


128/510 





— End assembly — 
199 bytes 
Errors: 

Symbol Cable - alphabetical order: 



CH 


=$01 


? CSROFF =$80A1 


? CURSOR -$8085 


CV 


=$02 


DEVO 


=$C080 


DEVI =$C08l 


DEV2 =$C082 


EXIT 


=$8084 


FLAGS 


=$0738 


FORMAT =$07 


? GOTOXY =$804C 


? INIT 


=$8000 


MLOOP 


=$8057 


MODE =$0478 


M0DEMASK=$06 


MS LOT 


= $05 


MTBL 


=$80BF 


MULT1PLY=$80B2 


NO =$04 


PAGE 


= $03 


PAGSEL 


=$8075 


? SCROLL =$8023 


START =$0638 


? STOADV 


=$8060 


YSAVE 


=$08 











Symbol Cable - numerical order: 



CH 


=$01 


CV =$02 


PAGE 


-$03 


NO 


= $04 


MSLOT 


= $05 


MODEMASK=$06 


FORMAT 


«$07 


YSAVE 


=$08 


MODE 


=$0478 


START =$0638 


FLAGS 


-$0738 


? INIT 


=$8000 


SCROLL 


=$8023 


? GOTOXY =$804C 


MLOOP 


-$8057 


? STOADV 


=$806D 


PACSEL 


=$8075 


EXIT =$8084 


? CURSOR 


=$8085 


? CSROFF 


-$80A1 


MULTIPL 


Y=$80B2 


MTBL =$80BF 


DEVO 


= $C080 


DEVI 


$C08) 
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APPENDIX S 



Schematic Diagram 



Note: VIDEX 1 = ULT-VXP-003 
VIDEX2 -ULTVXP-004 
VIDEX 3 = ULT-VXP-005 



» 












jFi-jfl 2 i 5- 



If 






S-RSriai l 



L,.|8j. - 



Mi' 



BE 






I 



KUPv/s 



L -^ 



,•■,,=777 ^ 7?^ im 



«J 



llllIil jr^m 



tTT 






m 



mrnrr 



mill» Mil II M rr* 
^h--V,.i:,.': .,~m 2 E 3? -S 






^ffiLLLLL 



-nrrrrrr 

If 



II U U Vl 



rrrrrrrrrn- 



tttftttttti 



t *■ e 2 r r .. ■ ■ • ' -.^-^ 



LLLLLLD V i 



1 I I J 
ttrrttirni I I 



tt^ 



1 5 



&£ 



<SH+hhr 



g iMH&U-ffi f, 



*T° 



j j j j i I j j 



j~~ 



S-n- 

il 






SoSBooSo 



J44%%$J?4| j i 



-is 



M\MUUU 



0-9- 



1 11 1 



I 



7# 



J 



'JntfW 



-..,■-•■ asssa .? ^B*i^^ 



JJJJ ^^ ^ 



On 






r^b^_ 



LiH*^^ 1 r* 



=> j j 1 1 j j I I [j— 1 f 



il 



^ ..... ..■.:.-.;-.;..-.«; 



-ftft-IW-w — 4 — 1 



g 



— S.1- 



APPENDIX Y 



Theory off Operation 



Your UltraTerm is the most sophisticated product we have produced to 
date. Since this appendix will describe its operation in some detail, you will 
find this to be the most technically complex text in this manual. To 
understand the operation of the card you will have to refer to the schematic 
diagram as you read this material. We suggest you make a photocopy of 
the schematic before you start. This backup copy will save a tremendous 
amount of wear and tear on the binding of your manual. 

We will describe the operation of your UltraTerm by taking you on a guided 
tour from the Apple bus to the video output connector. Along the way we 
will point out the major building blocks of your card and describe their 
operation in some detail. In this appendix, as in the rest of the manual, we 
will refer to memory and I/O addresses as if your card is plugged into 
slot #3. 

There is one aspect of the UltraTerm design which deserves some 
preliminary explanation. This is the concept of "pipelining". We use this 
term to refer to the temporary storage and delay of certain signals within 
the UltraTerm. Some elements of the UltraTerm, particularly the character 
generator EPROM, cannot produce valid outputsquickly enough to be 
useful during a single video character time (about 296 nanoseconds). For 
this reason, their outputs are stored and delayed until the next character 
time. (Even with pipelining, we still need to use EPROMs with access times 
less than 300 nanoseconds for the character generator.) Other signals, 
such as the video attributes, can be produced more quickly. These signals 
are also stored until they can be shifted out in synchronization with the 
character information. For example, the video senalizer receives eight 
parallel data bits and begins shifting out the dots for one character while 
the information for the next character is being produced by the character 
generator EPROM. 



Section Y.1 APPLE BUS INTERFACE 



There are three programmable array logic devices, (PALS), shown on the 
schematic as Videxl, Videx2 and Videx3, on your UltraTerm. These 
devices decode the addresses on the Apple bus, generate device 
selection signals for the circuits on your UltraTerm, and provide timing and 
synchronizations signals. They also detect addresses in the range SCF00 
to SCFFF and disable your UltraTerm's firmware as required when SCFFF 
is addressed. Videxl generates strobe signals which enable input and 
output latches U2 and U3. These devices transfer data to and from the 
video refresh memory. Quad latch U9 stores the data for the mode control 
port. The CRTC and the video refresh memory are selected by strobe 
outputs from Videxl and Videx2 and receive their data directly from the 
Apple bus. The device selected is determined by the two low-order 



—Y.1- 



address bits from the Apple. 

The eight low-order addresses for the video refresh memory are buffered 
by U1 0. The four high-order bits are generated by the mode control port 
(MCP), U9, and U1 1 . If your UltraTerm is in the 51 2-byte addressing mode 
in order to emulate a Videoterm, the twelfth bit is set to zero and only the 
lower 2048 bytes of the video refresh memory are used. 

The 2732A EPROM which contains the firmware has its outputs gated 
directly onto the Apple bus. Its outputs are enabled by a signal from 
Videxl. 



Section Y.2 FIRMWARE INTERFACE 

The firmware to operate your UltraTerm is contained in a 4K-byte 2732A 
EPROM, U6. The lower half of this IC contains seven versions of the code 
which appears at SCN00 to SCNFF, one for each slot. The segment of 
code which appears at each page is selected by address bits A8, A9 and 
A10. 

There are 2K bytes of address space available for use in the co-resident 
memory space at SC800. However, the upper 1 K bytes of this space is 
used by the video refresh memory. For this reason the firmware is split into 
two banks. These banks are selected with bit seven of the MCP. When the 
second bank of firmware is selected it overlays the Video Refresh Memory 
(VRM) at addresses from SCC00 to SCFE0. The first bank of the firmware 
always occupies the region from SC800 to SCBFF. 



Section Y.3 CRT CONTROLLER 

The CRTC, U1 5, is the central element of your UltraTerm. It is responsible 
for sequencing the addresses to the video refresh memory, displaying the 
cursor, generating synch pulses and controlling the display format. The 
programmability of this circuit is the key to generating the many different 
display modes you can use with your UltraTerm. 

The CRTC appears as a pair of memory locations (SC0B0 and SC0B1 ) to 
your Apple. The data stored at the first address selects the CRTC register. 
The data stored at the second address will be transferred to the selected 
CRTC register. A complete description of the functions of the CRTC 
registers is included in appendix C. 



Section Y,4 VIDEO REFRESH MEMORY 

The VRM stores the ASCII codes which your UltraTerm converts to video 
signals. The memory is made up of two high-speed (1 00 nS) static RAM 
chips, U6 and U7. This memory must be made available both to the 
Apple, which stores the ASCII data, and to the CRTC, which reads the 
ASCII data and converts it to video signals. In order for the video display to 



continue without interruptions, the CRTC must have priority in addressing 
the VRM. Otherwise, the video display would show black dashes as the 
video logic was denied access to the refresh memory. This problem is 
prevented on your UltraTerm by latching the addresses and data from the 
Apple and transferring them to the VRM when the CRTC is carrying out 
internal operations. 

The addresses sent to the VRM are selected by multiplexer chips U 1 2, 

U 1 3, and U 14. The timing PAL, Videx3 generates the signal which causes 
the multiplexers to select either the CRTC addresses or the Apple bus 
addresses. 

If your UltraTerm is in the Videoterm emulation mode and is using the 512- 
byte addressing mode, the lower 9 bits of the VRM address are taken from 
the Apple address bus. The upper two bits are latched from Apple 
addresses A3 and A2 when the slot-dependent I/O locations are read. 

When your UltraTerm is in the 256-byte mode, the upper four VRM 
address bits are taken from the lower four bits of the MCR 
bits are set by simply storing the proper high-order address data 
(combined with clock and page select bits in the high nybble) into the 
MCP This method avoids much of the address-manipulation arithmetic 
required in the 51 2-byte mode. 

RAM address arbitration (ensuring that the CRTC has priority) is 
accomplished by the timing PAL, Videx3. Latches U2 and U3 store the 
Apple's address and data while the CRTC is using the VRM for video 
display refreshing. 

Section Y.5 CHARACTER GENERATION 

The dot patterns which make up a displayed character are generated by 
combining the ASCII value for the character with the row address bits from 
the CRTC. The resulting address is used to fetch the dot pattern for one 
row of the character from the character generator EPROM, U21 The 
Standard/Alternate character set bit from the Video Attributes Register 
(VAR) is used to select either the upper or lower half of the 2732 EPROM. 
Latch U1 8 pipelines the address information to the character generator, 
delayed by one character clock time The high-order bit of this latch 
determines which of the two sets of attributes will be used with the 
character. The state of this bit selects either one or the other of the two bit 
patterns in the VAR, U 1 7. The functions of the different attribute bits are 
explained in chapter 8. The default attributes, set by the DIP switches S1 - 
S4, are loaded into the attribute register whenever the Apple RESET line is 
pulled low. 

The eight output bits of the character generator EPROM make up the first 
8 dots of a 9-cell wide matrix for the displayed character. The ninth dot is 
normally off, resulting in a space between characters. Sections of U27 and 
U28 and U34 are used to select certain characters (the line drawing and 
graphics characters) which will have the eighth dot duplicated into the 
ninth dot position. This allows us to display graphics characters which are 
completely connected from character to character. 



Section Y.6 TIMING GENERATION LOGIC 



Your UltraTerm has two crystal-controlled clock oscillators. One generates 
a clock with a frequency of 28.7595 MHz, the other a signal with a 
frequency of 1 7.430 M Hz. These oscillators consist of sections of U25 and 
their associated crystals and resistors. The 28.7595 MHz clock is used 
when you are in the 128, 132, or 160-column modes. The 17.430 MHz 
clock is used in the 80 and 96-column modes. These clock frequencies are 
the fundamental dot writing rate for the transfer of video dots to your video 
monitor. A character time consists of nine cycles of the dot clock. The clock 
which will be used is selected by bit 5 of the MCP A high value for this bit 
selects the 28.7595 MHz clock. This dot clock is used to shift the bits from 
the character generator through the video serializes U22. 

The clock signals which synchronize the operations of your UltraTerm are 
generated by a nine-state counter which is part of PAL Videx3. Outputs 
from this chip control the reading and writing of data for the VRM and the 
selection of data from the Video Attributes Register, 



Section Y.7 Video Combiner and Internal Video Switch 
(IVS) 

The video signal from U22 and the composite inverse video attribute are 
combined in gate U26. The Highlight/Lowlight attribute and the sync 
signals are combined with the video signal by a diode mixer. 

Transistors Q1 and Q2 form the internal video switch which selects either 
the Apple video or the UltraTerm video, depending on the status of IVS 
output, part of U26. These transistors and their controlling logic form the 
soft video switch which is controlled by bit 6 of the MCP When this bit is 
low, the video from the Apple is selected. 

The digital video, composite sync, and IVS outputs are sent to Molex 
connector J6 where they may be used by external devices. 



Section Y.8 CONNECTORS AND JUMPER BLOCKS 

Your UltraTerm has several connectors and jumper blocks which allow you 
to set default operating conditions. When you receive your board these 
jumpers are set to allow your UltraTerm to work properly with an Apple ][. 
The functions of the jumpers and connectors is explained in the following 
section. 

J1 This jumper plug is used to select either the standard IOSEL 
signal from the Apple or an internal IOSEL which always 
responds to addresses in the $C3XX memory region. When 
the internal IOSEL signal is used, the card will always work, 
even if the Apple IOSEL is inhibited. This isthe case if your 
UltraTerm is used in an Apple He with an 80-column or 



J2 



J3 



J4 



J5 



J6 



extended memory card in the auxiliary slot. When the internal 
IOSEL is active, the INHIBIT line of the Apple He is activated 
and the Apple 80-column firmware will be disabled. 

This jumper allows the selection of the standard or alternate 
character set by the high bit (bit 7) of the output character. It is 
normally set so that the character set is determined by bit 2 of 
the Video Attributes Register. 

This is the Video output connector. The cable to your monitor 
and to the Apple video output is connected here. 

The video waveform is controlled by this jumper. When the 
jumper is installed the video output pulses are square waves. 
Without the jumper plug, the pulses become triangular waves. 
The Apple Monitor /// and many other monitors will produce 
sharper characters with a triangular video waveform. 

Switching this jumper will invert the video output signal. This 
jumper is used in conjunction with J6 for special applications. 

This connector provides the composite Sync, Video and 
UltraTerm select signals. It is designed to be used with special 

video processing boards. 
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Figure Y.1 Ultra Term P.C. Board Layout 



Glossary 



APPLICATION PROGRAM An application program is a program which 
is written to accomplish a specific task. The program may be written 
in BASIC, Pascal or Machine Language. A payroll program or an 
accounting package are examples of applications programs, 

ASCII This is an acronym for American Standard Code for Information 
Interchange. This standard defines the way the alphabet, numbers 
and control characters are encoded by your computer. The ASCII 
codes use only seven of the eight bits in a byte, so we use the last bit 
to set special attributes for a displayed character. 

BANDWIDTH This is a measure of the range of frequencies which an 
electronic device can faithfully reproduce. If the bandwidth of a 
device such as a display monitor is too small, it cannot preserve all 
the information contained in the video signal. 

BASIC This is an acronym for Beginner's All-purpose Symbolic 
Instructional Code. It is the computer language, originally 
developed at Dartmouth University, which is used on most personal 
computers. APPLESOFT is a version of BASIC. 

BOOTSTRAP If you have an Apple with a disk system, when you first 
turn the power on, thecomputer will try to read the disk operating 
system (DOS) from the diskette. This procedure of reading a 
program into memory, then executing that program is called 
BOOTSTRAPPING. 

CONFIGURE When you change certain variables or routines in a 

program to take advantage of special hardware features, such as 
your UltraTerm card, you are CONFIGURING a program. 

CONSOLE This is the term the Pascal operating system uses to refer to 
the main text input and output system. On your Apple ][, console 
input comes from the keyboard and the console output appears on 
your video display. 

CRTC This is an acronym for Cathode Ray Tube Controller. This is an 

integrated circuit which automatically scans a block of memory, then 
converts the ASCII data in the memory to video signals. The CRTC 
also provides horizontal and vertical synchronization signals, and a 
cursor. 

CURSOR The cursor is the solid or flashing block on your display which 
indicates where the next character that you enter will appear on the 
video display. Different programs may alter the appearance of the 
cursor by changing certain registers inside the CRTC. 

EPROM This is an acronym for Electrically Programmable Read-Only 
Memory. An EPROM can be programmed in a special interface 
card, then used as a ROM by your UltraTerm card. While it is 
installed in your UltraTerm, the data in the EPROM cannot be 
altered. EPROMs can be erased by exposure to ultraviolet light, 
then re-programmed. 



ELECTRONIC SWITCH An electronic switch can select one of two 
signals, depending on the logic level on its control input. On your 
UltraTerm an electronic switch selects either the UltraTerm video or 
the Apple video signal. Electronic switches have no moving parts to 
wear out and can easily be controlled by your computer. 

FIRMWARE A program which is stored in an EPROM is firmware. It is 
called this because it is somewhere between hardware and 
software. Hardware cannot be changed, at least not without great 
difficulty and a knowledge of electrical engineering. Software is 
easily changed— if you know how to program your computer. 
Firmware can be changed, but it requires a special programming 
device. The firmware programs on your UltraTerm card control the 
operation of the card and its interaction with your computer. 

HARDWARE Your Apple ][ and UltraTerm are hardware. The electronic 
circuits which go together to make a particular device are called 

hardware. 

INTERLACE When your UltraTerm is m interlace mode, every other 
vertical scan is delayed by one-half of a horizontal scan time. Thus, 
every other complete screen will be one-half line lower than the 
previous field. The result is that there are twice as many horizontal 
scans on the screen. However, each scan will be refreshed only 30 
times per second instead of 60 times. You may consider that your 
UltraTerm is writing all the even-numbered horizontal lines in one 
thirtieth of a second and all the odd-numbered lines in the next 
thirtieth of a second. 

INVERSE VIDEO When your video display shows black characters on a 
light background, they are being displayed in inverse video. 

KEYBOARD ECHO When your computer sends all characters that you 
enter on the keyboard to the output device (the video display), your 
system is using keyboard echo. This allows you to use output 
commands by simply typing them on the keyboard. 

OPERATING SYSTEM This is the supervisor program that controls the 
use of the resources of your computer. The Pascal Operating 
System is responsible for processing input and output and 

executing commands which allow you to run utility or application 
programs. Apple DOS 3.3 is an operating system which allows 
floppy disks to be used with BASIC. 

OVERSCAN A video display monitor uses a beam of electrons to excite 
the phosphor which produces the lighted dots on the screen. When 
the electron beam starts scanning off the left edge of the screen and 
continues scanning past the right edge of the screen, this is called 
overscan. Since the scan must occur in a fixed interval, overscan 
reduces the time available to display characters on the screen. 

PERIPHERAL A peripheral is a separate piece of hardware which is 

connected to your computer to allow it to accomplish a specific task. 
A disk drive is a peripheral which allows you to store information on 
floppy disks. 



PHOSPHOR The inside of the display screen of your video monitor is 
coated with a chemical compound which emits light when it is struck 
by an electron beam. This chemical compound often contains the 
element Phosphorus, and is called a phosphor for this reason 

PROMPT A specfal character or word that your computer displays when 
it is waiting for input is called a prompt. The prompt for Applesoft is 
the ']' character. 

REGISTER This is simply a storage location whose contents affect the 
operation of a device inside or connected to your computer. The X 
and Y registers inside your Apple can control data storage 
operations. The registers in the CRTC used in your UltraTerm control 
the format of your video display. 

RESOLUTION This is a measure of the smallest dot which a video 
monitor can display. If the resolution of a display is poor, the dots 
which make up a character will appear to merge together and the 
characters will be fuzzy. Resolution is often limited by the bandwidth 
of the display electronics. 

UTILITY PROGRAM A general-purpose program which is designed to 
handle disk files or other types of computer data is called a Utility. 
Utilities generally do not care about the special significance to the 
data they handle— they simply move bytes around or set up data for 
other programs to use. The FID program provided with Apple DOS 
3.3 is a utility program. 

VIDEO DISPLAY This is the television-like device used to change the 
electrical signal generated by your UltraTerm into a visual display. 

WORD PROCESSOR A program which allows you to enter, edit, store 
and display text is a word processor. Most word processors allow 
you to specify such details of the printed document as the margins, 
right, center and left justification and page length. 



Index 



Applesoft 5.1,6.1 

Applewriter II 7.3 

ASCII Code Chart . . . .A. 1 

Block Diagram 1 .3 

Character Attributes 5.2, 5.6 

Character Sets B.1 

Character RAM Y.2 

Configuration 6.1-6.6 

Connectors Y.4 

Control Characters . . . 5.2 

CP/M . .6.6 

CRTC Registers 8.9, C.1 

Direct Keyboard Input 8.4 

Display Modes 5.2 

Display Monitors 1.6,9.1 

DOS 6.1 

Escape Codes 5.5 

Firmware Listing F.1 

Glossary . , ix 

Graphics Mode 8.3, 8.7 

Highlight/Lowlight 5.7, 8.9 

Input Commands 5.1 

Internal Video Switch . .4.3 

Installation 2.1 

Inverse Video 5.5 

Memory Usage 8.9 

Mode Control Port . . .8.9 

Normal Video 5.5 

Output Commands 5.2, 8.6 

Pascal 6.4,8.5 

RMA Form inside back cover 

Schematic Diagram 5.1 

Theory of Operation Y.1 

Video Attribute Register 5.6, Y.2 

Visicalc 7.1 

Warranty Repair 3.4 

Wordstar 7.2 



RMA Form for UltraTerm RMA tt_ 

Call (503-758-0521) for RMA0 Serial #_ 

Previous Service RMA_ 



Addr._ 



Phone #(days)_ 



Phone #(evenings)_ 



Name . Shipping Address: 

Organization __ Name 



Addr.. 



Shipping Instr.. 



Date purchased Received. 



System Configuration: 

□ Autostart D Old Monitor ROM 

□ Apple ][ plus D Apple ][ 
Apple He □ Apple/// 

Resident Language: 

□ Applesoft D Integer 
Pascal □ CP/M 

Number of disc drives: 

List on the back of the page all products installed in the Apple at the time the 
failure occurred, and any software that was in use. 

For problems that occurred during installation, did you get a: 

□ power light? D Display? 
C power-up beep? 

Were there any installation errors? 

Does the problem occur with: 

80-Col. Modes Wider Modes (128-160 Col.; 



Describe, in detail, the nature of the problem. 



Describe, in detail, the Circumstances under which the problem •ccurrea. 



Does the problem occur only several minutes after jiowerup 9 
C Yes H No 



COMMENTS: 



ffi 



idex 



Corvallis, Oregon 97330 
503/758-0521 



